Infatica MCP

Infatica MCP documentation

The Model Context Protocol (MCP) lets an AI client talk to external tools. Infatica runs an MCP server that exposes your account's runs, analyses, schedules, usage, and balance as tools the model can call on your behalf.

The MCP server is authenticated with a Personal Access Token that you control.

Endpoint

https://dataplatform.infatica.io/mcp

Connect

First, create a Personal Access Token in Settings -> Personal Access Tokens and choose the scopes you want to grant.

For a guided setup with the token already filled in, open Settings -> MCP Connect.

Replace infpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx in the examples below with your Personal Access Token.

Claude Code

claude mcp add --transport http --scope user infatica https://dataplatform.infatica.io/mcp \
  --header "Authorization: Bearer infpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Cursor

Add the server to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "infatica": {
      "url": "https://dataplatform.infatica.io/mcp",
      "headers": {
        "Authorization": "Bearer infpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude.ai

Go to Settings -> Connectors -> Add custom connector and use the following values:

URL: https://dataplatform.infatica.io/mcp
Header: Authorization: Bearer infpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Local development with stdio

Run the server directly against a local gateway instead of using the hosted HTTP endpoint:

INFATICA_PAT=infpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
GATEWAY_BASE_URL=http://localhost:8081 \
python services/mcp-server/server.py

Authentication and scopes

Every request authenticates with a Personal Access Token in the following format:

Authorization: Bearer infpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

A token only unlocks the tools covered by the scopes granted to it. Calling a tool outside the token's scopes returns a 403 error.

Scope	Grants
runs:read	Read runs, exports, stats, logs, bulk status, usage, and audit log.
runs:write	Create, retry, and cancel runs, bulk runs, and individual items.
analyses:read	List and read analyses, comparisons, and templates.
analyses:write	Create analyses, compare runs, and retry comparisons.
schedules:write	List, create, update, and delete recurring schedules. There is no separate read scope for schedules.
keys:read	Read stored LLM keys in the web UI only. This scope is not exposed as a tool.

check_balance and refresh_balance use your session and do not require a scope.

Personal Access Tokens cannot create or revoke other Personal Access Tokens. Token management is available only through a browser session.

Tool reference

Infatica MCP exposes 28 tools grouped by area. The model chooses the right tool based on your request.

Runs

Tool	What it does	Scope	Type
list_runs	List runs with optional filters: type, status, query, and date range.	runs:read	read-only
create_run	Create a new data collection run.	runs:write	write
get_run	Get a run's details and all item statuses.	runs:read	read-only
retry_run	Retry all failed items in a run.	runs:write	write
cancel_run	Cancel a running or queued run.	runs:write	destructive
export_run	Download run results as json, csv, md, or html.	runs:read	read-only
get_run_stats	Show dashboard stats: 14-day counts, status mix, and totals.	runs:read	read-only
get_run_logs	Get the event log for a run.	runs:read	read-only
retry_item	Retry a single failed or cancelled item in a run.	runs:write	write

Bulk runs

Tool	What it does	Scope	Type
create_bulk_run	Fan the same items across multiple engines.	runs:write	write
get_bulk_run	Get the status of a bulk run and all its child runs.	runs:read	read-only
retry_bulk_run	Retry all failed child runs in a bulk run.	runs:write	write

Analysis: single run

Tool	What it does	Scope	Type
create_analysis	Run an LLM analysis over a completed run's results.	analyses:write	write
list_analyses	List analyses for a run.	analyses:read	read-only
get_analysis	Get a specific analysis result.	analyses:read	read-only
list_analysis_templates	List single-run analysis templates.	analyses:read	read-only

Cross-run comparison

Tool	What it does	Scope	Type
compare_runs	Compare 2 to 10 runs in one cross-run analysis.	analyses:write	write
list_comparisons	List your cross-run comparisons.	analyses:read	read-only
list_comparison_templates	List cross-run comparison templates.	analyses:read	read-only
retry_comparison	Retry a failed comparison.	analyses:write	write

Schedules

Tool	What it does	Scope	Type
list_schedules	List your recurring schedules. This is read-only, but gated on schedules:write because there is no schedules:read scope.	schedules:write	read-only
create_schedule	Create a recurring schedule for a run.	schedules:write	write
update_schedule	Update a schedule, including status, cron, or preset.	schedules:write	write
delete_schedule	Delete a schedule with soft delete.	schedules:write	destructive

Usage

Tool	What it does	Scope	Type
get_usage_summary	Show usage summary with a daily breakdown.	runs:read	read-only
list_usage_events	Show individual usage events per request.	runs:read	read-only

Balance

Tool	What it does	Scope	Type
check_balance	Show your cached Infatica account balance.	session	read-only
refresh_balance	Force-refresh balance from upstream.	session	write

Audit

Tool	What it does	Scope	Type
get_audit_log	Show recent audit entries, including who did what via PAT or session.	runs:read	read-only

Prompts and slash commands

Infatica MCP also exposes canned multi-step flows that your client can show as slash commands.

Prompt	What it does
/scrape_urls	Kick off a scraper run from a list of URLs.
/compare_latest	Compare your most recent runs of a given type.
/usage_report	Summarize your usage over a date range.
/run_status	Check the status of a run by ID.
/check_account	Show balance and account status.

Troubleshooting

Symptom	Fix
401 Authentication failed	Token is missing, mistyped, or revoked. Create a fresh Personal Access Token in Settings and update your config.
403 missing required scope	Your token does not include the required scope. The error message names the missing scope. Recreate the token with that scope.
Connection or timeout errors	Check that the URL is exactly https://dataplatform.infatica.io/mcp and that the Authorization header is present on every request.