{"openapi":"3.1.0","info":{"title":"One Agent a Day","version":"1.2.0","summary":"Discovery API for the free daily agent catalog.","description":"Every day, one free AI agent you can paste into a chat: a prompt and a short demo. Everyday helpers for refund letters, contracts, and saying no, plus prompts for code, tests, docs, and games. Read the catalog, fetch one agent including its prompt, 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://www.oneagentaday.com"}},"servers":[{"url":"https://www.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://www.oneagentaday.com/api/schema.json#/$defs/AgentSummary"},"AgentDocument":{"$ref":"https://www.oneagentaday.com/api/schema.json#/$defs/AgentDocument"},"Catalog":{"$ref":"https://www.oneagentaday.com/api/schema.json#/$defs/Catalog"},"AgentEnvelope":{"$ref":"https://www.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"}}}}}}