Search / io.publicapis/directory
PublicAPIs.io
R0· no sign-inSearch 1,500+ public APIs with docs, code and auth/free-tier filters; list or sponsor your API.
v1.0.0 · active · website · descriptor JSON · versions
Search / io.publicapis/directory
R0· no sign-inSearch 1,500+ public APIs with docs, code and auth/free-tier filters; list or sponsor your API.
v1.0.0 · active · website · descriptor JSON · versions
{
"mcpServers": {
"directory": {
"type": "http",
"url": "https://publicapis.io/mcp"
}
}
}claude mcp add --transport http directory https://publicapis.io/mcp[mcp_servers.directory]
url = "https://publicapis.io/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"directory": {
"type": "remote",
"url": "https://publicapis.io/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"directory": {
"type": "http",
"url": "https://publicapis.io/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=directory&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcHVibGljYXBpcy5pby9tY3AifQ%3D%3D"
}{
"servers": {
"directory": {
"type": "http",
"url": "https://publicapis.io/mcp"
}
}
}{
"mcpServers": {
"directory": {
"httpUrl": "https://publicapis.io/mcp"
}
}
}extensions:
"directory":
enabled: true
name: "directory"
type: streamable_http
uri: "https://publicapis.io/mcp"
timeout: 300
protocol.modernsupports 2026-07-28 (server/discover)protocol.statelessanswers without a sessionprotocol.transportstreamable HTTPprotocol.list_ttltool list is cacheable (ttlMs 3600000)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotationsonly 6 of 8 tools declare readOnlyHint or destructiveHinttools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_api (destructiveHint, idempotentHint, openWorldHint); get_quickstart (destructiveHint, idempotentHint, openWorldHint); list_offerings (destructiveHint, idempotentHint, openWorldHint); …tools.token_costabout 837 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes, stability.rug_pulltool history recorded for 4 of the 7 days neededdeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+dns-namespace +website +reachable +uptime-100% +updated-5d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://publicapis.io/mcp streamable-http | none | yes | 100% | 1736 ms | 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05 | 2026-10-20 |
compare_apisread-only | Compare 2-5 APIs side by side (auth, free tier, HTTPS, pricing, docs summary) to choose one. Pass slugs from search_apis. |
get_apiread-only | Everything about one API by slug (from search_apis): documentation summary, endpoints, auth, pricing and links. Use before writing integration code. |
get_dealread-only | Status of a deal: negotiating, agreed, awaiting_approval, awaiting_payment (payment_url is included), publishing, live (live_url), rejected. Also returns the last messages. |
get_quickstartread-only | Ready-to-run example code for calling an API, in javascript, python or curl. Use when you are about to integrate an API into code. Verified samples are marked verified=true. |
list_offeringsread-only | Ways to get an API listed or sponsored on PublicAPIs.io, with fixed prices, current sponsorship availability and the rules. |
search_apisread-only | Find a public API or data source for a task: use this whenever the user (or your code) needs an API, dataset or third-party service, e.g. weather, geocoding, payments, sports scores, crypto prices, jobs, LLMs. Searches 1,500+ APIs on PublicAPIs.io and returns name, description, category, link and signals (auth: none/api_key/oauth, free_tier, https). Filter with auth="none" for APIs that need no key, free=true, https=true. |
send_message | Reply to the broker in an open deal. Returns the broker's answer and the deal status. |
start_deal | Open a conversation with the PublicAPIs.io broker agent to list or sponsor an API. Say what you want in plain language and include the API name, website and a contact email if you have them. Returns deal_id and deal_key (keep both; they are needed to continue) and the broker's reply. Every deal is approved by a person before payment. |
Schemas: list_tools.
{
"name": "io.publicapis/directory",
"title": "PublicAPIs.io",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://publicapis.io/mcp",
"type": "streamable-http"
}
],
"version": "1.0.0",
"websiteUrl": "https://publicapis.io/agents",
"description": "Search 1,500+ public APIs with docs, code and auth/free-tier filters; list or sponsor your API."
}