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, query data tables, and administer workspace assets directly from your AI development environment using natural language.

AIRO as an MCP server

How it works

The AIRO MCP server authenticates through OAuth. When you connect for the first time, your MCP client opens a browser window to complete Workato authentication. After authentication, the server exposes approximately 90 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	Query data tables and lookup tables
Jobs and tests	Inspect job history and manage test cases
Administration	Manage projects, folders, collaborators, OAuth profiles, on-prem groups, and event streams

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, or another MCP client)
A browser available for OAuth authentication

Connect the AIRO MCP server

Complete the following steps to connect the AIRO MCP server to your MCP client.

Claude Code

Open your terminal.

Run the following command:

bash

claude mcp add -t http airo_mcp https://app.workato.com/airo_mcp

Start a new Claude Code session.

Complete the OAuth authentication flow when prompted in your browser.

Verify the connection by running /mcp in Claude Code. The airo_mcp server should appear with a connected status.

Claude Desktop

Open Claude Desktop.

Go to Settings > Developer.

Click Edit Config to open the claude_desktop_config.json file.

Add the following configuration:

json

{
  "mcpServers": {
    "airo_mcp": {
      "url": "https://app.workato.com/airo_mcp"
    }
  }
}

Save your changes.

Restart Claude Desktop and start a new chat.

Complete the OAuth authentication flow when prompted in your browser.

Cursor

Open Cursor.

Go to Settings > Cursor Settings.

Click MCP & Integrations in the sidebar.

Click + New MCP Server to open the mcp.json file.

Add the following configuration:

json

{
  "mcpServers": {
    "airo_mcp": {
      "url": "https://app.workato.com/airo_mcp"
    }
  }
}

Save your changes.

Start a new chat with your Cursor agent and complete the OAuth authentication flow when prompted.

START A NEW CHAT

Start a new chat with your agent after saving changes. Cursor agents only have access to the tools and capabilities available when a chat begins. Agents can't detect or use MCP configurations, servers, or tools added after a chat starts.

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.

Query workspace data

Look up records in data tables and lookup tables to verify data or support debugging.

Query the customer onboarding data table for records where status is "blocked".

Manage workspace access

Review project permissions and collaborator access across your workspace.

List all projects and show which collaborators have access to the Finance Automation project.

Last updated:

AIRO MCP server ​

How it works ​

Prerequisites ​

Connect the AIRO MCP server ​

Claude Code ​

Claude Desktop ​

Cursor ​

Use cases ​

Build and test a recipe ​

Create a Genie with knowledge sources ​

Build an MCP server ​

Investigate job failures ​

Query workspace data ​

Manage workspace access ​