MCP Server

The Kadoa MCP server gives any compatible AI model or agent a standardized, secure way to work with Kadoa via the Model Context Protocol. It has tools for creating, running, and managing workflows, fetching and exporting extracted data, and configuring notifications, variables, and templates, all through natural language. Kadoa’s MCP server follows the authenticated remote MCP spec, so the server is centrally hosted and managed. For help getting started after setup, see some of our example prompts.

Setup

General

The server is centrally hosted and managed by Kadoa, using Streamable HTTP as its transport. There is nothing to install and no API key to manage. There are two ways to connect:

Personal connection (https://mcp.kadoa.com/mcp): You sign in with your own Kadoa account, and every tool call runs as you, under your role and active team. Best for individual use.
Service connector (https://service.mcp.kadoa.com/mcp): A workspace admin generates OAuth credentials once, and applications or organization members connect as a shared workspace service account, with no Kadoa login. Best for organization-wide rollouts and app contexts where nobody can sign in interactively. See MCP Service Connector →.

	Personal connection	Service connector
Who signs in	Each user	Nobody; OAuth client ID and secret
Acts as	You (your role and team)	Shared workspace service account
Set up by	Each user	A workspace admin, once
Best for	Individual use	Organizations, apps, automations

For a personal connection, add the server in your client: a browser opens so you can sign in with your Kadoa account and grant access. The connection then stays authorized; if a session expires, your client prompts you to sign in again.

With a personal connection, the MCP server acts as you: every tool runs under your Kadoa role and active team, and each action is recorded in the workflow’s history.

Instructions for specific clients follow below.

Claude

Team, Enterprise (Claude.ai) A Claude organization owner can roll Kadoa out to everyone at once: add a custom connector for https://mcp.kadoa.com/mcp under Admin settings → Connectors (members sign in with their own Kadoa accounts), or use the service connector so members connect without Kadoa accounts. Individual members can also add it themselves under Settings → Connectors → Add custom MCP with the same URL. Free, Pro (Claude.ai)

Go to Settings → Connectors → Add custom MCP
Enter the URL: https://mcp.kadoa.com/mcp
Sign in with your Kadoa account via OAuth

Claude Code

claude mcp add kadoa --transport http https://mcp.kadoa.com/mcp

Then run /mcp in a Claude Code session to go through the authentication flow.

Claude Desktop

Add the server to your Claude Desktop config file (create it if it doesn’t exist), then restart Claude Desktop:

// 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": {
      "type": "http",
      "url": "https://mcp.kadoa.com/mcp"
    }
  }
}

ChatGPT

Go to Settings → Connectors → Add MCP server
Enter the URL: https://mcp.kadoa.com/mcp
Choose OAuth authentication and sign in with your Kadoa account

Codex

codex mcp add kadoa --url https://mcp.kadoa.com/mcp

Then run codex mcp login kadoa to go through the authentication flow. If this is your first remote MCP server in Codex, enable the rmcp client in ~/.codex/config.toml first:

[features]
experimental_use_rmcp_client = true

Cursor

// .cursor/mcp.json
{
  "mcpServers": {
    "kadoa": {
      "type": "http",
      "url": "https://mcp.kadoa.com/mcp"
    }
  }
}

Gemini CLI

gemini mcp add -t http kadoa https://mcp.kadoa.com/mcp

Others

Any MCP-compatible client can connect with the following settings:

URL: https://mcp.kadoa.com/mcp
Transport: Streamable HTTP
Auth: OAuth (sign in with your Kadoa account)

Permissions

The tools you can use depend on your team role. Viewers and Compliance Officers have read-only access:

Tool	Member / Admin / Owner	Viewer	Compliance Officer
`list_workflows`
`get_workflow`
`get_workflow_history`
`fetch_data`
`export_data`
`create_workflow`
`run_workflow`
`update_workflow`
`approve_workflow`
`pause_workflow`
`delete_workflow`
`whoami`
`list_notification_channels`
`create_notification_channel`
`delete_notification_channel`
`list_notification_settings`
`configure_notifications`
`delete_notification_setting`
`list_variables`
`get_variable`
`create_variable`
`update_variable`
`delete_variable`
`create_template`
`get_template`
`list_templates`
`update_template`
`delete_template`
`create_template_version`
`list_template_schemas`
`save_workflow_as_template`
`list_changes`
`get_change`

If a tool is not available for your role, you’ll receive an error message with instructions to contact your team admin.

Tools

The server exposes tools covering the full workflow lifecycle, notifications, variables, templates, and team management:

All tools

Tool	Description
`create_workflow`	Create an agentic navigation workflow from a prompt
`list_workflows`	List all workflows with status
`get_workflow`	Get detailed workflow information including prompt, schedules, and notification config
`get_workflow_history`	List recent edit-audit entries for a workflow with field-level diffs
`run_workflow`	Execute a workflow
`fetch_data`	Get extracted data from a workflow (paginated, with filters and sorting)
`export_data`	Export the full extracted dataset as a signed URL, ideal for large workflows
`delete_workflow`	Delete a workflow
`approve_workflow`	Approve and activate a workflow
`pause_workflow`	Pause an active workflow so it stops running on its schedule
`update_workflow`	Update workflow configuration and schema
`create_realtime_monitor`	Create a real-time monitoring workflow
`whoami`	Show current user details and team memberships
`team_list`	List all teams you belong to and see which is active
`team_switch`	Switch the active team by name or ID
`list_notification_channels`	List notification channels for a workflow or workspace
`create_notification_channel`	Create an email, webhook, Slack, or WebSocket notification channel
`delete_notification_channel`	Delete a notification channel
`list_notification_settings`	List event-to-channel notification mappings
`configure_notifications`	Set up notifications for workflow events in one step
`delete_notification_setting`	Remove a notification event-to-channel mapping
`list_variables`	List all variables in the current team scope
`get_variable`	Get a specific variable by ID
`create_variable`	Create a key-value variable (STRING, NUMBER, BOOLEAN, or JSON)
`update_variable`	Update a variable’s key, value, or data type
`delete_variable`	Delete a variable (two-step confirmation)
`create_template`	Create a reusable template for workflow configurations
`get_template`	Get a template by ID, including all published versions
`list_templates`	List all templates in the current team
`update_template`	Update a template’s name or description
`delete_template`	Delete a template (two-step confirmation)
`create_template_version`	Publish a version with prompt, schema, and notifications
`list_template_schemas`	List schemas associated with a template
`list_template_workflows`	List workflows linked to a template
`link_template_to_workflows`	Link existing workflows to a template
`unlink_template_from_workflows`	Unlink workflows from a template, keeping their configuration
`apply_template_version`	Roll out a template version to linked workflows
`save_workflow_as_template`	Create a template from an existing workflow’s configuration
`list_changes`	List detected data changes across real-time monitoring workflows
`get_change`	Get detailed information about a specific detected change

The status field returned by list_workflows and get_workflow shows the computed workflow state (Complete, Running, Failed, Paused, Scheduled, etc.) rather than just the raw lifecycle state. You can filter with list_workflows using the state parameter (ACTIVE, FAILED, PAUSED, PREVIEW).

Scheduling

The create_workflow tool accepts an interval parameter for recurring extractions (defaults to ONLY_ONCE). Use CUSTOM with cron expressions for fine-grained control. See Scheduling → for all available intervals and examples.

Fetching and exporting data

Two tools retrieve extracted data: use fetch_data for paginated reads (default 50 rows, max 500) with filters, sortBy, and order; use export_data for the full dataset. It returns a self-authenticating signed URL ideal for Claude for Excel (‘Get Data from Web’) or pandas/duckdb code execution.

Workflow history

get_workflow_history returns recent edit-audit entries for a workflow with field-level diffs (added, removed, and changed values) so you can see who modified what and when.

Common use cases

Once connected, you manage the full workflow lifecycle through natural conversation. Copy an example prompt into your client to explore what’s possible; see the tools above for the full surface:

Build and run a scraper

Create a workflow that extracts product name, price, and rating from https://sandbox.kadoa.com/ecommerce, run it, and show me the first results.

Scheduled monitoring

Set up a workflow that scrapes competitor prices from https://sandbox.kadoa.com/ecommerce daily at 6:00, and email me when a run finishes or fails.

Change detection review

Show me all changes my real-time monitors detected this week and summarize what moved.

Data export and analysis

Export the full ‘Product Monitor’ dataset and analyze price trends by category.

Workflow maintenance

Update the ‘Product Monitor’ schema to add a rating field, then pause the old ‘Legacy Scraper’ workflow.

Template rollouts

Save ‘Product Monitor’ as a template called ‘Product Scraper’, then create a workflow from it for each of these five store URLs.

Team administration

List my teams, switch to Acme Corp, and show me which workflows are failing there.

Troubleshooting

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
Re-authenticate via OAuth if prompted

Authentication failed

Your OAuth session may have expired, so re-authenticate when prompted by your MCP client
If switching teams, verify the team exists with team_list before using team_switch

Foundations

Security & Compliance

Build with UI

Build with Code

Integrations

Setup

General

Claude

Claude Code

Claude Desktop

ChatGPT

Codex

Cursor

Gemini CLI

Others

Permissions

Tools

Scheduling

Fetching and exporting data

Workflow history

Common use cases

Troubleshooting

I don’t have access to Kadoa

Authentication failed

​Setup

​General

​Claude

​Claude Code

​Claude Desktop

​ChatGPT

​Codex

​Cursor

​Gemini CLI

​Others

​Permissions

​Tools

​Scheduling

​Fetching and exporting data

​Workflow history

​Common use cases

​Troubleshooting

​I don’t have access to Kadoa

​Authentication failed

Setup

General

Claude

Claude Code

Claude Desktop

ChatGPT

Codex

Cursor

Gemini CLI

Others

Permissions

Tools

Scheduling

Fetching and exporting data

Workflow history

Common use cases

Troubleshooting

I don’t have access to Kadoa

Authentication failed