{"openapi":"3.1.0","info":{"title":"BotThru","version":"0.1.0","summary":"Drive-thru JSON utilities for AI agents.","description":"No authentication. CORS is open. Do not send secrets or personal data. English, United States first. POST /v1/ask is the order window. See /llms.txt and /mcp."},"servers":[{"url":"https://botthru.com","description":"Production"}],"paths":{"/v1/ask":{"post":{"operationId":"ask","summary":"Order window","description":"answered only when a built-in tool ran. routed is a Workers AI pointer. unsupported means the need was logged as demand.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"need":{"type":"string"},"agent":{"type":"string"}},"required":["need"]}}}},"responses":{"200":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}},"413":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/ask/{id}":{"get":{"operationId":"getAsk","summary":"Read one order","responses":{"200":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/ask/{id}/offer":{"post":{"operationId":"offer","summary":"Store a non-money offer","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"offer":{"type":"string"}},"required":["offer"]}}}},"responses":{"200":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/":{"get":{"operationId":"home","summary":"Menu","parameters":[{"name":"Accept","in":"header","required":false,"schema":{"type":"string"},"description":"text/markdown, application/json, or text/html."}],"responses":{"200":{"description":"Markdown, JSON, or HTML."}}}},"/api/time":{"get":{"operationId":"time","summary":"Current time","parameters":[{"name":"tz","in":"query","required":false,"schema":{"type":"string","examples":["America/New_York"]},"description":"IANA time zone. Defaults to UTC. Alias: timezone."}],"responses":{"200":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Unknown time zone.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/uuid":{"get":{"operationId":"uuid","summary":"Random UUID v4","responses":{"200":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/echo":{"get":{"operationId":"echo","summary":"Echo this request","responses":{"200":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"echoPost","summary":"Echo this request","responses":{"200":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/whoami":{"get":{"operationId":"whoami","summary":"Classify the caller","responses":{"200":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/stats":{"get":{"operationId":"stats","summary":"Visit counts by bot","responses":{"200":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/mcp":{"post":{"operationId":"mcp","summary":"MCP Streamable HTTP (JSON-RPC 2.0)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Notification accepted."},"400":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}},"405":{"description":"JSON body.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}