{"openapi":"3.1.0","info":{"title":"mcpheaven API","version":"1.0.0","description":"mcpheaven is the catalog and MCP gateway AI agents use to find and call software capabilities. One connection, searchable by task, run in Germany. Without a key: 120 requests per hour per address, public catalog only."},"servers":[{"url":"https://mcpheaven.com"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"API key starting with mch_, created in the console."}},"schemas":{"Capability":{"type":"object","required":["slug","name","provider","category","agent_actions","description","status","private"],"properties":{"slug":{"type":"string","example":"hetzner-cloud"},"name":{"type":"string"},"provider":{"type":"string"},"category":{"type":"string"},"agent_actions":{"type":"string","description":"What an agent can do with it."},"description":{"type":"string","description":"Why it is in the catalog."},"status":{"type":"string","enum":["planned","beta","available"]},"private":{"type":"boolean","description":"True for capabilities of your own workspace."},"endpoint":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri"},"markdown_url":{"type":"string","format":"uri"},"verified_at":{"type":"string","format":"date"}}}}},"security":[{},{"bearer":[]}],"paths":{"/api/v1/capabilities":{"get":{"operationId":"searchCapabilities","summary":"Search the catalog by task","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"The task in plain language."},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"Results","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Capability"}}}}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/v1/capabilities/{slug}":{"get":{"operationId":"getCapability","summary":"One catalog entry","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Entry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Capability"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/v1/categories":{"get":{"operationId":"listCategories","summary":"Categories with counts","responses":{"200":{"description":"Categories"}}}},"/api/v1/plans":{"get":{"operationId":"listPlans","summary":"Plans, prices and limits","responses":{"200":{"description":"Plans"}}}},"/mcp":{"post":{"operationId":"mcp","summary":"MCP endpoint (JSON-RPC 2.0, Streamable HTTP)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"JSON-RPC response"},"202":{"description":"Notification accepted"},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}