{
  "$schema": "https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/server-card.schema.json",
  "schemaVersion": "2025-11-05",
  "serverInfo": {
    "name": "apis.io",
    "title": "APIs.io federated API catalog",
    "version": "0.1.0",
    "description": "Discovery surface for the apis.io network. Until a hosted MCP transport is published, agents should use the RFC 9727 api-catalog and Agent Skills index referenced below as the primary discovery surface.",
    "publisher": {
      "name": "API Evangelist",
      "url": "https://apievangelist.com"
    },
    "homepage": "https://apis.io",
    "documentation": "https://apis.io/about/"
  },
  "transport": {
    "status": "planned",
    "note": "No hosted MCP transport is currently exposed. Use the discovery URLs in `discovery` to consume the catalog directly, or load the Agent Skills below into an MCP-capable client."
  },
  "discovery": {
    "apiCatalog": "https://apis.io/.well-known/api-catalog",
    "agentSkills": "https://apis.io/.well-known/agent-skills/index.json",
    "apisJson": "https://apis.io/apis.json",
    "sitemap": "https://apis.io/sitemap.xml"
  },
  "capabilities": {
    "tools": {
      "listChanged": false,
      "planned": [
        {
          "name": "search_apis",
          "description": "Search the apis.io catalog by keyword, capability, tag, or provider.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "query": {
                "type": "string",
                "description": "Free-text search query."
              },
              "scope": {
                "type": "string",
                "enum": ["apis", "providers", "capabilities", "schemas", "tags"],
                "description": "Which subdomain catalog to search. Defaults to a federated search across all."
              }
            },
            "required": ["query"]
          }
        },
        {
          "name": "fetch_api_spec",
          "description": "Given an apis.io API URL or anchor, return the OpenAPI / AsyncAPI / Postman specification referenced by its api-catalog entry.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "anchor": {
                "type": "string",
                "format": "uri",
                "description": "The apis.io anchor URL for the API (e.g., https://apis.apis.io/apis/{provider}/{api}/)."
              }
            },
            "required": ["anchor"]
          }
        },
        {
          "name": "describe_provider",
          "description": "Return the APIs.json description and api-catalog entry for an apis.io provider.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "provider": {
                "type": "string",
                "description": "Provider slug as used at https://providers.apis.io/providers/{provider}/."
              }
            },
            "required": ["provider"]
          }
        }
      ]
    },
    "resources": {
      "listChanged": false
    },
    "prompts": {
      "listChanged": false
    }
  },
  "links": [
    {
      "rel": "api-catalog",
      "href": "https://apis.io/.well-known/api-catalog",
      "type": "application/linkset+json"
    },
    {
      "rel": "agent-skills",
      "href": "https://apis.io/.well-known/agent-skills/index.json",
      "type": "application/json"
    },
    {
      "rel": "describedby",
      "href": "https://apis.io/apis.json",
      "type": "application/json"
    }
  ]
}