{"openapi":"3.1.0","info":{"title":"One Agent a Day","version":"1.1.0","summary":"Discovery API for the free daily agent catalog.","description":"Read the catalog, fetch one agent including its prompt, subscribe to the daily list or the Pro waitlist, or call the MCP endpoint. Prompts are published under CC BY 4.0.","license":{"name":"Creative Commons Attribution 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"email":"hello@oneagentaday.com","url":"https://oneagentaday.com"}},"servers":[{"url":"https://oneagentaday.com","description":"Production"}],"tags":[{"name":"Catalog"},{"name":"Subscribe"},{"name":"Discovery"}],"paths":{"/api/agents.json":{"get":{"tags":["Catalog"],"operationId":"listAgents","summary":"List published agents, newest first.","responses":{"200":{"description":"Catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}}}}},"/api/agents/{slug}.json":{"get":{"tags":["Catalog"],"operationId":"getAgent","summary":"Fetch one agent, including prompt and config.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agent document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEnvelope"}}}},"404":{"description":"Unknown slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/schema.json":{"get":{"tags":["Discovery"],"operationId":"getSchema","summary":"JSON Schema for the catalog.","responses":{"200":{"description":"JSON Schema document"}}}},"/api/openapi.json":{"get":{"tags":["Discovery"],"operationId":"getOpenApi","summary":"This document.","responses":{"200":{"description":"OpenAPI 3.1 document"}}}},"/api/feedback":{"post":{"tags":["Catalog"],"operationId":"sendFeedback","summary":"Record whether an agent was useful. The vote is appended to a local log.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequest"}}}},"responses":{"200":{"description":"Logged, or ignored because the honeypot was filled."},"400":{"description":"Invalid body"},"404":{"description":"Unknown agent slug"},"429":{"description":"Rate limited"}}}},"/api/subscribe":{"post":{"tags":["Subscribe"],"operationId":"subscribe","summary":"Join the daily list, the Pro waitlist, or ask for a custom agent.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeRequest"}}}},"responses":{"200":{"description":"Accepted"},"400":{"description":"Invalid body"},"429":{"description":"Rate limited"},"502":{"description":"Upstream provider failed"}}}},"/api/mcp":{"get":{"tags":["Discovery"],"operationId":"mcpCard","summary":"MCP server card.","responses":{"200":{"description":"Server card"}}},"post":{"tags":["Discovery"],"operationId":"mcpRpc","summary":"MCP Streamable HTTP JSON-RPC endpoint.","description":"Supports initialize, ping, tools/list, tools/call, resources/list, and resources/read. Tools: list_agents, get_agent, search_agents.","responses":{"200":{"description":"JSON-RPC response"}}}},"/llms.txt":{"get":{"tags":["Discovery"],"operationId":"llmsTxt","summary":"Short index for language models.","responses":{"200":{"description":"text/plain"}}}},"/llms-full.txt":{"get":{"tags":["Discovery"],"operationId":"llmsFull","summary":"Full agent prompts in one text file.","responses":{"200":{"description":"text/plain"}}}},"/feed.xml":{"get":{"tags":["Discovery"],"operationId":"rss","summary":"RSS 2.0 feed.","responses":{"200":{"description":"application/rss+xml"}}}},"/atom.xml":{"get":{"tags":["Discovery"],"operationId":"atom","summary":"Atom feed.","responses":{"200":{"description":"application/atom+xml"}}}}},"components":{"schemas":{"AgentSummary":{"$ref":"https://oneagentaday.com/api/schema.json#/$defs/AgentSummary"},"AgentDocument":{"$ref":"https://oneagentaday.com/api/schema.json#/$defs/AgentDocument"},"Catalog":{"$ref":"https://oneagentaday.com/api/schema.json#/$defs/Catalog"},"AgentEnvelope":{"$ref":"https://oneagentaday.com/api/schema.json#/$defs/AgentEnvelope"},"SubscribeRequest":{"type":"object","required":["email","list"],"properties":{"email":{"type":"string","format":"email"},"list":{"type":"string","enum":["daily","pro","custom"]},"note":{"type":"string","maxLength":2000}}},"FeedbackRequest":{"type":"object","required":["slug","vote"],"properties":{"slug":{"type":"string"},"vote":{"type":"string","enum":["yes","no"]},"note":{"type":"string","maxLength":500}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}