{"openapi":"3.1.0","info":{"title":"MCPBundles Directory API","version":"v1","description":"Search the MCPBundles directory index and invoke eligible tools without a connected MCP session. Discovery-only listings return install metadata; NONE-auth managed and open remote rows support HTTP tool calls."},"servers":[{"url":"https://www.mcpbundles.com/api/directory/v1"}],"paths":{"/":{"get":{"summary":"API discovery document","responses":{"200":{"description":"Discovery JSON"}}}},"/search":{"get":{"summary":"Ranked directory search","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":30}},{"name":"connect_path","in":"query","schema":{"type":"string"}},{"name":"harvest_only","in":"query","schema":{"type":"boolean"}},{"name":"catalog_listing","in":"query","schema":{"type":"boolean"}},{"name":"kind","in":"query","schema":{"type":"string"}},{"name":"registry_eligible","in":"query","schema":{"type":"boolean"},"description":"When true, match the same subset as /api/registry (gallery-eligible only)."}],"responses":{"200":{"description":"Listing search page"}}}},"/servers/by-registry-name/{registryName}":{"get":{"summary":"Listing detail by MCP Registry name","parameters":[{"name":"registryName","in":"path","required":true,"schema":{"type":"string"},"description":"e.g. com.mcpbundles/stripe (URL-encode the slash)."}],"responses":{"200":{"description":"Server detail"}}}},"/servers/{directorySlug}/versions":{"get":{"summary":"Published version list (one version per listing)","parameters":[{"name":"directorySlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Version metadata"}}}},"/servers/{directorySlug}":{"get":{"summary":"Listing detail, tools, and agent actions","parameters":[{"name":"directorySlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"live","in":"query","schema":{"type":"string"},"description":"Set to 1 for live tool refresh on this detail GET."}],"responses":{"200":{"description":"Server detail"}}}},"/servers/{directorySlug}/tools/{toolName}":{"get":{"summary":"One tool metadata and invoke URL","parameters":[{"name":"directorySlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"toolName","in":"path","required":true,"schema":{"type":"string"}},{"name":"live","in":"query","schema":{"type":"string"},"description":"Set to 1 to refresh this tool from upstream when eligible."}],"responses":{"200":{"description":"Tool detail JSON"}}},"post":{"summary":"Invoke one listed tool","parameters":[{"name":"directorySlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"toolName","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Tool result JSON"}}}}},"x-mcpbundles":{"discoveryUrl":"https://www.mcpbundles.com/api/directory/v1","documentation":"https://www.mcpbundles.com/agents.md"}}