Copy page

Documentation

MCP Server

The APIs.io catalog is also available to AI agents as a Model Context Protocol server over Streamable HTTP:

Code
https://apis.io/mcp

It's generated from the same OpenAPI contract as the REST API, so the two never drift. Every tool is read-only.

Connect

Point any MCP-capable client at the endpoint. For example, in a client that takes a remote MCP URL:

Code
{
  "mcpServers": {
    "apis-io": {
      "url": "https://apis.io/mcp"
    }
  }
}

The server speaks JSON-RPC: initialize, tools/list / tools/call, prompts/list / prompts/get, and resources/list / resources/read. If your client shows prompts, start there — they chain the right tools for a job (see Prompts below).

Tools

apis_io_search is the power tool — find APIs, providers, or tags by free text, tags, providers, artifact types, industry, region, and rating band. The full set (Pro-gated tools marked 🔒):

Discovery

• find_apis / get_api, find_providers / get_provider, find_tags / get_tag
• find_artifacts — artifacts of a given type (OpenAPI, AsyncAPI, Postman, …) across the catalog
• find_similar_providers / find_similar_apis, get_provider_artifacts / get_api_artifacts
• get_openapi, get_provider_onboarding
• resolve — turn any identifier (domain, URL, github.com/<org>) into the provider it belongs to (free)
• enrich_provider — one call, pick field groups (profile, onboarding, artifacts free; rating, insights 🔒) instead of chaining several get_provider* calls

Venture Capital (VC firms as a first-class entity + their portfolio graph — free)

• find_vcs — search VC firms by name, thesis tags, or category; sort by portfolio_on_network / portfolio_total / portfolio_rating
• get_vc — one firm: identity, fund facts, portfolio summary (band distribution + average rating); view=full inlines the whole portfolio
• vc_portfolio — a firm's portfolio companies, each network-matched + rated (filter is_provider=true for only API providers, or by band / min_score)
• find_investors — the reverse edge: which VC firms back a given provider/company

Saved Workspace (a Pro dimension — persistent per-user state, requires a key) 🔒

• save_search / list_saved_searches / run_saved_search / delete_saved_search
• saved_search_net_new — what newly matches your saved criteria since you last checked (the agent-native demand report)
• create_list / list_lists / get_list / add_to_list / delete_list — build and keep named shortlists/stacks
• These are the same capability as the REST API's /me/* endpoints — the API and MCP share one implementation and one paywall, so they never drift.

Taxonomy — find_industries / get_industry, find_regions / get_region, find_areas / get_area are all free (browse + get); only the ranked get_industry_leaders / get_region_leaders / get_area_leaders are 🔒

Ratings — get_rating_rubric (free); find_ratings / get_provider_rating / get_rating_history / find_rating_movers 🔒

Synthesis — recommend_stack is freemium (free top pick per capability, Pro for the full stack + alternatives + APIs.json); compare_providers, gap_analysis, industry_gap_analysis, whats_changed, export_stack 🔒

Per-type artifact discovery — a find_<type> for each artifact type (find_rules, find_mcp, find_plans, find_arazzo, find_asyncapis, find_channels, …), free except find_scopes / find_security 🔒

Data products — export_dataset (the whole ratings/providers dataset in one pull, Business license, with co_brand) and story_leads (owner-only editorial rollup)

Insights (demand-side: what the Fortune 1000 + API providers build, buy, and hire for)

• Free: find_company_insights, insights_dimensions, insights_adoption
• Pro 🔒: get_company_insight (full 40-dimension profile), company_gaps, match_providers (the supply↔demand join)

🔒 tools require a Pro/Business key (Plans). Call tools/list for the authoritative, always-current set:

Code
curl -s https://apis.io/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Prompts

Prompts are guided flows — each one chains the right tools for a job, so you don't have to know the tool names. Free prompts run for anyone; 🔒 prompts need a Pro/Business key and are listed for everyone (they upsell on use). Call prompts/list for the always-current set, prompts/get to run one.

Discover & adopt — find_api, provider_overview, explain_artifact, integrate_provider, api_readiness_check, agent_readiness_scan, best_in_class, explore_industry, explore_area, rating_methodology, insights_landscape, demand_vs_supply

Improve a provider you own — improve_my_score; claim_and_improve 🔒, benchmark_against_peers 🔒

Sell & go to market — sell_upmarket 🔒

Data & the "state of" story (media) — state_of_report 🔒 (Business), movers_briefing 🔒, category_leaderboard 🔒

Decide — design_api_stack 🔒, vendor_shortlist 🔒, audit_api_estate 🔒, find_alternatives 🔒, build_agent_toolset 🔒, track_provider_changes 🔒, company_readiness 🔒

Sensemaking (owner) — story_leads, network_pulse 🔒

Code
# list prompts, then run one
curl -s https://apis.io/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"prompts/get","params":{"name":"improve_my_score","arguments":{"slug":"twilio"}}}'

Resources

Attachable, readable context an agent can pin into a session. Free unless marked 🔒.

• apis://catalog, apis://ratings/rubric, apis://llms.txt — the network root, the scoring rubric, and the machine-readable index
• apis://changes 🔒 — the recent catalog + rating movement feed
• Templated: apis://provider/{slug}, apis://provider/{slug}/openapi, apis://tag/{slug} (free); apis://provider/{slug}/dossier, apis://industry|region|area/{slug}, apis://stack/{capabilities} 🔒

Call resources/list and resources/templates/list for the authoritative set.

See the API Reference for the underlying operations each tool maps to.