Kadoa MCP server

Connect Kadoa to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Kadoa MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get crawl results tool in Kadoa
  • Use the manage workflow tool in Kadoa
  • Use the get data changes tool in Kadoa
  • Use the start crawl tool in Kadoa
  • Use the ad hoc extraction tool in Kadoa
  • Use the run workflow tool in Kadoa

Supported Tools

get_crawl_results

Get Crawl Results

Check crawl session status and retrieve crawled pages. Optionally fetch the content of a specific page in markdown or HTML format. Use this to monitor crawl progress and retrieve results.

manage_workflow

Manage Workflow

Perform lifecycle actions on a Kadoa workflow: pause, resume, schedule, delete, or update metadata. Use this to change a workflow's name, URLs, schedule, tags, monitoring configuration, schema, or navigation settings.

get_data_changes

Get Data Changes

Retrieve detected data changes from monitored workflows. Filter by workflow IDs, date range, and pagination. Each change includes the affected data, type of change (added, removed, changed), and field-level differences.

start_crawl

Start Crawl

Start a new web crawling session. Crawls accessible subpages of a website and converts them into structured markdown or JSON. Provide a single URL or multiple URLs from the same domain. Returns a session ID for tracking progress.

adhoc_extraction

Ad-hoc Extraction

Extract data from a single webpage instantly without creating a persistent workflow. Provide a URL and a schema ID (or use built-in modes like "html", "body", or "markdown" for raw content). Useful for one-off data needs or testing extraction configurations.

run_workflow

Run Workflow

Execute a Kadoa extraction workflow immediately. Optionally pass variables for dynamic URL placeholders and a row limit. Returns the job ID for tracking the run.

list_workflows

List Workflows

Search and retrieve Kadoa extraction workflows. Filter by state, run status, tags, or free-text search. Returns workflow summaries including name, URL, state, schedule, and record counts.

get_workflow_details

Get Workflow Details

Retrieve comprehensive details of a Kadoa workflow including its configuration, schema, run history, health status, and monitoring settings. Use this to inspect a workflow's full setup before running or modifying it.

get_workflow_data

Get Workflow Data

Retrieve extracted data from a Kadoa workflow. Supports pagination, sorting, and filtering with operators like EQUALS, CONTAINS, GREATER_THAN, etc. Can also retrieve data from a specific workflow run by providing a run ID.

list_locations

List Locations

List available scraping countries and ISO codes. Use an ISO code when selecting a manual location for ad-hoc extraction.

create_workflow

Create Workflow

Create a persistent extraction workflow from one or more URLs and natural-language instructions. Returns the workflow ID for inspecting, running, and retrieving its data.

Connect Kadoa to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Kadoa in Metorial. In your Metorial portal, enable the Kadoa MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Kadoa tools.

Run Kadoa through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Kadoa and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Kadoa tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Kadoa

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Sentry

Track, manage, and resolve application errors and performance issues. List, query, and bulk-update issues and error events with filters like status, assignment, and tags. Create and manage releases, associate commits, and upload source maps. Configure issue alert rules and metric alert rules with notification actions. Set up cron monitors to detect missed or failed scheduled jobs. Build custom dashboards with configurable widgets. Run ad-hoc Discover queries across errors and transactions for performance analysis. Manage organizations, teams, projects, and members. Provision users via SCIM. Access session replay data.

Bitbucket

Manage Git repositories, pull requests, and CI/CD pipelines on Bitbucket Cloud. Create, fork, and configure repositories within workspaces and projects. Create, review, approve, merge, and decline pull requests with inline code comments. Browse source code, list commits, and manage branches and tags. Trigger, monitor, and manage Bitbucket Pipelines. List workspace members, configure repository default reviewers and branch restrictions, create and manage repository webhooks, and search code across repositories.

Technical notes for Kadoa

Extract, transform, and deliver structured data from websites, PDFs, and documents using AI-powered web scraping. Create and manage data extraction workflows targeting single or multiple URLs with configurable schedules. Define reusable data schemas and templates for consistent extraction across sites. Perform ad-hoc extractions from single webpages without persistent workflows. Crawl website subpages and convert them to structured JSON or markdown. Monitor web sources for data changes and receive alerts for updates. Validate extracted data quality with configurable rules. Export data in CSV or JSON, or deliver directly to S3, Snowflake, Google Sheets, and other integrations.

Frequently asked questions

Common questions about connecting Kadoa to AI agents with Metorial.

  1. How many tools does the Kadoa MCP server have?
    The Kadoa MCP server exposes 11 tools, including Get Crawl Results, Manage Workflow, Get Data Changes. Each one is governed and traced through Metorial.
  2. Kadoa exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Kadoa MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Kadoa and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Kadoa MCP server yourself or use the hosted gateway.

Connect Kadoa to production AI agents

See how Metorial gives your team governed access to Kadoa, with tracing and security controls built in.