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 serverAIRO 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:

CategoryWhat you can do
RecipesCreate, edit, search, and manage recipes, including step-level operations, field mapping, conditions, and connections
Skills and MCPConvert recipes to skills and create or manage MCP servers
Genies and knowledge basesCreate and configure Genies, manage knowledge bases, and assign knowledge sources
Blueprints and assetsWork with blueprints, asset maps, and asset metadata
DataCreate and manage data table schema
Jobs and testsInspect 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. Run node -v in 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:

1

Sign in to Workato.

2

Go to Workspace admin > API clients > Client roles.

3

Open an existing client role or create a client role.

4

Enable the AIRO MCP feature for the role.

The AIRO MCP feature enabled in the Project assets list of a client roleEnable the AIRO MCP feature for the client role

5

Click Save changes.

6

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: