MCP Server

The Kadoa MCP server exposes workflow management tools to AI coding assistants via the Model Context Protocol. This lets you create, run, and manage web scraping workflows using natural language from your AI assistant.

Supported Clients

Claude Code
Claude Desktop
Cursor
Codex
Gemini CLI
Any MCP-compatible client

Setup

Claude Code
Claude Desktop
Cursor
Codex
Gemini CLI

Add for the current project:

claude mcp add kadoa -- npx -y @kadoa/mcp

Or add for all projects:

claude mcp add -s user kadoa -- npx -y @kadoa/mcp

Set your API key:

export KADOA_API_KEY=tk-your_api_key

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kadoa": {
      "command": "npx",
      "args": ["-y", "@kadoa/mcp"],
      "env": {
        "KADOA_API_KEY": "tk-your_api_key"
      }
    }
  }
}

Restart Claude Desktop after saving.

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "kadoa": {
      "command": "npx",
      "args": ["-y", "@kadoa/mcp"],
      "env": {
        "KADOA_API_KEY": "tk-your_api_key"
      }
    }
  }
}

Restart Cursor after saving.

codex mcp add kadoa -- npx -y @kadoa/mcp

Or add to ~/.codex/config.toml:

[mcp_servers.kadoa]
command = "npx"
args = ["-y", "@kadoa/mcp"]

[mcp_servers.kadoa.env]
KADOA_API_KEY = "tk-your_api_key"

Network access: Codex blocks network by default. The MCP server needs to reach api.kadoa.com, so enable network access in ~/.codex/config.toml:

sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

Restart Codex after changing the config.Alternative: Codex SkillYou can also use Kadoa on Codex as an agent skill powered by the Kadoa CLI. Install it with:

codex install-skill https://github.com/kadoa-org/kadoa-cli

The skill auto-triggers when you ask Codex to scrape or extract data from websites. It also requires network access as configured above.

gemini mcp add -t stdio kadoa npx -- -y @kadoa/mcp

Or add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "kadoa": {
      "command": "npx",
      "args": ["-y", "@kadoa/mcp"],
      "env": {
        "KADOA_API_KEY": "tk-your_api_key"
      }
    }
  }
}

Restart Gemini CLI after saving.

API Key

Get your API key from kadoa.com/settings. The MCP server resolves your key in this order:

KADOA_API_KEY environment variable
~/.kadoa/config.json (shared with the Kadoa CLI)

If you have the CLI installed, run kadoa login and the MCP server picks up your saved key automatically.

Tools

The server exposes eight tools covering the full workflow lifecycle:

Tool	Description
`create_workflow`	Create a workflow from a natural language prompt
`list_workflows`	List all workflows with status
`get_workflow`	Get detailed workflow information
`run_workflow`	Execute a workflow
`fetch_data`	Get extracted data from a workflow
`delete_workflow`	Delete a workflow
`approve_workflow`	Approve and activate a workflow
`update_workflow`	Update workflow configuration and schema

Usage Examples

Once the MCP server is configured, ask your AI assistant:

“List my Kadoa workflows”
“Create a workflow to extract product prices from example.com”
“Run workflow abc123 and show me the results”
“Fetch the latest data from workflow abc123 as a table”
“Update the schema for workflow abc123 to include a rating field”
“Delete workflow abc123”

Troubleshooting

“No API key found”

Run kadoa login (requires npm i -g @kadoa/cli), or
Set KADOA_API_KEY in your MCP config or environment
Verify your API key starts with tk-

“I don’t have access to Kadoa”

Verify the MCP server is configured in the correct config file
Restart your MCP client after configuration changes

“getaddrinfo EAI_AGAIN” or network errors in Codex

Codex blocks network access by default
Enable network_access = true in ~/.codex/config.toml (see Codex tab above)
Restart Codex after changing the config

Get Started

Security & Compliance

Build with UI

Build with Code

Integrations

Supported Clients

Setup

API Key

Tools

Usage Examples

Troubleshooting

Get Started

Security & Compliance

Build with UI

Build with Code

Integrations

​Supported Clients

​Setup

​API Key

​Tools

​Usage Examples

​Troubleshooting

Supported Clients

Setup

API Key

Tools

Usage Examples

Troubleshooting