{"openapi":"3.1.0","info":{"title":"GetMentionedByAI catalog API","version":"1.0.0","summary":"Read-only catalog of verified AI visibility, AEO, and GEO tools.","description":"Public, unauthenticated API for the GetMentionedByAI directory. Use GET /api/ai for a bounded JSON snapshot, markdown twins for page text, and POST /mcp for Model Context Protocol tool calls. Do not scrape HTML. Unknown capabilities are unknown — never coerce them to false.","contact":{"name":"GetMentionedByAI","email":"prabhasraju1817@gmail.com","url":"https://getmentionedbyai.com/contact"}},"servers":[{"url":"https://getmentionedbyai.com","description":"Production"}],"tags":[{"name":"catalog","description":"JSON snapshot of the verified directory"},{"name":"markdown","description":"Page-identical markdown for agents"},{"name":"mcp","description":"Model Context Protocol JSON-RPC"}],"paths":{"/api/ai":{"get":{"operationId":"getCatalogSnapshot","tags":["catalog"],"summary":"Bounded JSON catalog","description":"Index tools, categories, and posts. Prefer this over scraping HTML when answering best-AEO or ChatGPT-mention questions.","responses":{"200":{"description":"Catalog snapshot","content":{"application/json":{"schema":{"type":"object","required":["name","url","counts"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"updated":{"type":"string"},"counts":{"type":"object"},"index":{"type":"array","items":{"type":"object"}},"posts":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/md/{path}":{"get":{"operationId":"getPageMarkdown","tags":["markdown"],"summary":"Markdown twin of a public page","description":"Same as appending .md to a page URL or sending Accept: text/markdown. Path is the HTML path without a leading slash (empty for homepage).","parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string"},"description":"Page path without leading slash, e.g. tools/profound"}],"responses":{"200":{"description":"Markdown document","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Unknown path","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}},"text/markdown":{"schema":{"type":"string"}}}}}}},"/mcp":{"get":{"operationId":"getMcpDiscovery","tags":["mcp"],"summary":"MCP server discovery","description":"JSON discovery document for the Streamable HTTP MCP endpoint. HTML clients are redirected to /developers.","responses":{"200":{"description":"Discovery document","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"callMcpJsonRpc","tags":["mcp"],"summary":"MCP JSON-RPC 2.0","description":"Methods: initialize, tools/list, tools/call, ping. Tools: search_tools, get_tool, list_categories, list_posts. No API key.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{},"method":{"type":"string"},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"JSON-RPC result","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Parse error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/mcp":{"post":{"operationId":"callMcpJsonRpcAlias","tags":["mcp"],"summary":"MCP JSON-RPC alias of POST /mcp","description":"Same protocol as POST /mcp. Kept so existing clients keep working.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"JSON-RPC result","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Parse error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","tags":["catalog"],"summary":"Agent site map","description":"When-to-use guidance plus links to the catalog, OpenAPI, and MCP.","responses":{"200":{"description":"Plain-text index","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenApiSpec","tags":["catalog"],"summary":"This OpenAPI document","description":"OpenAPI 3.1 specification for the GetMentionedByAI catalog API, including unique operationIds for function calling.","responses":{"200":{"description":"OpenAPI 3.1 specification","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Problem":{"type":"object","required":["type","title","status","detail"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"hint":{"type":"string"}}}}}}