AIRO MCP server
The AIRO MCP server exposes Workato AIRO's full platform capabilities to MCP-compatible AI clients such as Claude Code, Claude Desktop, Cursor, and ChatGPT. This enables you to build recipes, manage Genies, create MCP servers, and manage data table schema directly from your AI development environment using natural language.
AIRO as an MCP server
How it works
The AIRO MCP server authenticates with a Workato API token. This token comes from an API client with the AIRO MCP feature enabled. After you add it to your MCP client configuration and connect, the server exposes tools organized into the following categories:
| Category | What you can do |
|---|---|
| Recipes | Create, edit, search, and manage recipes, including step-level operations, field mapping, conditions, and connections |
| Skills and MCP | Convert recipes to skills and create or manage MCP servers |
| Genies and knowledge bases | Create and configure Genies, manage knowledge bases, and assign knowledge sources |
| Blueprints and assets | Work with blueprints, asset maps, and asset metadata |
| Data | Create and manage data table schema |
| Jobs and tests | Inspect job history and manage test cases |
Use the help tool within your MCP client to get detailed information about any specific tool, including input schemas and usage guidance.
The AIRO MCP server respects your Workato account permissions. Actions performed through the MCP server follow the same access controls as actions performed in the Workato platform.
Prerequisites
You must have the following before you configure the AIRO MCP server:
- A Workato account with AIRO access
- An MCP-compatible client installed (Claude Code, Claude Desktop, Cursor, ChatGPT, or another MCP client)
- Node.js installed and available in your
PATH. Runnode -vin your terminal to verify the installation. - A Workato API token with the AIRO MCP feature enabled. Refer to Generate an API token for more information.
Generate an API token
The AIRO MCP server requires an API token issued from an API client with the AIRO MCP feature enabled.
Complete the following steps to generate your token:
Sign in to Workato.
Go to Workspace admin > API clients > Client roles.
Open an existing client role or create a client role.
Enable the AIRO MCP feature for the role.
Enable the AIRO MCP feature for the client role
Click Save changes.
Obtain your API client token or create an API client, then copy and store the generated token.
The AIRO MCP server expects an Authorization: Bearer <token> header, where <token> is the token you generated. For example: wrkaus-xxxxxxxxxxxxxxxxxx.
Connect the AIRO MCP server
Complete the following steps to connect the AIRO MCP server to your MCP client.
Use cases
The following examples demonstrate common workflows with the AIRO MCP server.
Build and test a recipe
Use AIRO to create a multi-step recipe from a natural language description, then save and test it without leaving your development environment.
Create a recipe that syncs new Salesforce opportunities to Jira issues.
Add an OpenAI step to summarize the opportunity before creating the Jira issue.
Save the recipe and show me the test cases.Create a genie with knowledge sources
Set up a genie and connect it to relevant knowledge bases so it can answer domain-specific questions.
Create a new genie called "Sales Intelligence" and assign the CRM knowledge base to it.Build an MCP server
Create an MCP server from your workspace assets so other AI clients can connect to your tools.
Build an MCP server called "Sales Tools" using the lead enrichment and deal scoring skills from the Sales Automation project.Investigate job failures
Inspect recent job history to diagnose errors in production recipes.
List the last 10 jobs for recipe 1555928 and show me any errors.Manage a data table
Create a data table and define its schema without leaving your development environment.
Create a data table to store approver thresholds by region.Last updated: