{
 "name": "Agent MCP Directory API",
 "version": "v1",
 "edition": "2026-11-04",
 "documentation": "https://agentmcpdirectory.com/developers/",
 "openapi": "https://agentmcpdirectory.com/openapi.json",
 "api_catalog": "https://agentmcpdirectory.com/.well-known/api-catalog",
 "auth": "none",
 "rate_limit": {
  "requests": 120,
  "window_seconds": 60
 },
 "versioning": {
  "current": "v1",
  "policy": "breaking changes ship under a new prefix; the old prefix stays for 180 days",
  "announcements": "https://agentmcpdirectory.com/developers/"
 },
 "endpoints": [
  {
   "path": "/api/v1/search_directory",
   "method": "GET",
   "summary": "Search the directory",
   "parameters": [
    "q",
    "category",
    "mcp_status",
    "auth_type",
    "transport",
    "has_cli",
    "limit",
    "cursor"
   ],
   "example": {
    "category": "Payments & Fintech",
    "mcp_status": "verified"
   },
   "paginated": true
  },
  {
   "path": "/api/v1/get_company",
   "method": "GET",
   "summary": "One company in full",
   "parameters": [
    "domain"
   ],
   "example": {
    "domain": "stripe.com"
   },
   "paginated": false
  },
  {
   "path": "/api/v1/list_categories",
   "method": "GET",
   "summary": "List categories with counts",
   "parameters": [],
   "example": {},
   "paginated": false
  },
  {
   "path": "/api/v1/get_directory_stats",
   "method": "GET",
   "summary": "Directory totals",
   "parameters": [],
   "example": {},
   "paginated": false
  },
  {
   "path": "/api/v1/get_census",
   "method": "GET",
   "summary": "Act Layer Census",
   "parameters": [
    "cohort",
    "category",
    "file"
   ],
   "example": {
    "cohort": "top10k"
   },
   "paginated": false
  },
  {
   "path": "/ask",
   "method": "GET, POST",
   "summary": "NLWeb 0.55 ask",
   "example": {
    "query": "stripe"
   }
  }
 ],
 "datasets": [
  {
   "key": "directory",
   "title": "MCP and CLI Directory rows",
   "description": "One row per company: status, endpoint, transport, auth type, tool count and names, CLI package, OpenAPI file, registries, verification date and the entry page.",
   "downloads": [
    {
     "url": "https://agentmcpdirectory.com/data/mcp-directory-2026-11-04.json",
     "type": "application/json"
    },
    {
     "url": "https://agentmcpdirectory.com/data/mcp-directory-2026-11-04.csv",
     "type": "text/csv"
    }
   ]
  },
  {
   "key": "census",
   "title": "Act Layer Census",
   "description": "How many probed domains publish each act-layer discovery file, by cohort and by Ora leaderboard category, from the shared crawl of 4 November 2026.",
   "downloads": [
    {
     "url": "https://agentmcpdirectory.com/data/act-layer-census-2026-11-04.json",
     "type": "application/json"
    },
    {
     "url": "https://agentmcpdirectory.com/data/act-layer-census-2026-11-04.csv",
     "type": "text/csv"
    }
   ]
  }
 ],
 "mcp": {
  "endpoint": "https://agentmcpdirectory.com/mcp",
  "transport": "streamable-http",
  "protocol_versions": [
   "2025-11-25",
   "2025-06-18",
   "2025-03-26"
  ],
  "server_card": "https://agentmcpdirectory.com/mcp/server-card",
  "manifest": "https://agentmcpdirectory.com/.well-known/mcp.json",
  "tools": [
   "search_directory",
   "get_company",
   "list_categories",
   "get_directory_stats",
   "get_census"
  ]
 },
 "ask": {
  "endpoint": "https://agentmcpdirectory.com/ask",
  "protocol": "NLWeb 0.55",
  "methods": [
   "GET",
   "POST"
  ],
  "streaming": "streaming=true or Accept: text/event-stream",
  "example": "stripe"
 },
 "licence": {
  "name": "CC BY 4.0",
  "url": "https://creativecommons.org/licenses/by/4.0/"
 }
}