{"openapi":"3.1.0","info":{"title":"AgentReady Business Registry","description":"AI agent discovery API for local Australian businesses — hotels, trades, campervan hire, property intelligence, job platforms. All links point directly to the business. No middleman. No commission.","version":"0.2.0"},"paths":{"/llms.txt":{"get":{"summary":"Llms Txt","description":"Generate llms.txt dynamically from live data.","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/agents.json":{"get":{"summary":"Agents Json","operationId":"agents_json_agents_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/robots.txt":{"get":{"summary":"Robots Txt","operationId":"robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/smithery.yaml":{"get":{"summary":"Smithery Yaml","description":"Smithery registry metadata.","operationId":"smithery_yaml_smithery_yaml_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/.well-known/mcp.json":{"get":{"summary":"Mcp Manifest","description":"MCP server discovery manifest — standard for registries and AI clients.","operationId":"mcp_manifest__well_known_mcp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/businesses":{"get":{"summary":"Search Businesses","operationId":"search_businesses_businesses_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Search term","default":"","title":"Q"},"description":"Search term"},{"name":"location","in":"query","required":false,"schema":{"type":"string","description":"City or area","default":"","title":"Location"},"description":"City or area"},{"name":"type","in":"query","required":false,"schema":{"type":"string","description":"Business type: hotel, trade, campervan_hire","default":"","title":"Type"},"description":"Business type: hotel, trade, campervan_hire"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/businesses/{business_id}":{"get":{"summary":"Get Business","operationId":"get_business_businesses__business_id__get","parameters":[{"name":"business_id","in":"path","required":true,"schema":{"type":"string","title":"Business Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/businesses/{business_id}/offerings":{"get":{"summary":"Get Offerings","operationId":"get_offerings_businesses__business_id__offerings_get","parameters":[{"name":"business_id","in":"path","required":true,"schema":{"type":"string","title":"Business Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/businesses/{business_id}/contact":{"get":{"summary":"Get Contact","operationId":"get_contact_businesses__business_id__contact_get","parameters":[{"name":"business_id","in":"path","required":true,"schema":{"type":"string","title":"Business Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/schema/{business_id}":{"get":{"summary":"Get Jsonld","description":"Return JSON-LD Schema.org markup for a business.","operationId":"get_jsonld_schema__business_id__get","parameters":[{"name":"business_id","in":"path","required":true,"schema":{"type":"string","title":"Business Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/kit/{business_id}":{"get":{"summary":"Get Kit","description":"Return agent-ready kit (JSON-LD snippet, llms.txt, robots.txt, instructions).","operationId":"get_kit_kit__business_id__get","parameters":[{"name":"business_id","in":"path","required":true,"schema":{"type":"string","title":"Business Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/kit/{business_id}/preview":{"get":{"summary":"Kit Preview","description":"HTML preview of agent-ready kit with copy-to-clipboard buttons.","operationId":"kit_preview_kit__business_id__preview_get","parameters":[{"name":"business_id","in":"path","required":true,"schema":{"type":"string","title":"Business Id"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/demo/{business_id}":{"get":{"summary":"Ai Visibility Report","description":"AI Visibility Report — shows what AI agents see for this business.","operationId":"ai_visibility_report_demo__business_id__get","parameters":[{"name":"business_id","in":"path","required":true,"schema":{"type":"string","title":"Business Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/audit/{business_id}":{"get":{"summary":"Gap Analysis","description":"Golden Standard Gap Analysis — what data is missing for AI agents to recommend this business.","operationId":"gap_analysis_audit__business_id__get","parameters":[{"name":"business_id","in":"path","required":true,"schema":{"type":"string","title":"Business Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/report/{business_id}":{"get":{"summary":"Proof Report Json","description":"AI recommendation proof report — JSON data for a specific business.","operationId":"proof_report_json_report__business_id__get","parameters":[{"name":"business_id","in":"path","required":true,"schema":{"type":"string","title":"Business Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/report/{business_id}/view":{"get":{"summary":"Proof Report Html","description":"AI recommendation proof report — HTML one-pager for sales.","operationId":"proof_report_html_report__business_id__view_get","parameters":[{"name":"business_id","in":"path","required":true,"schema":{"type":"string","title":"Business Id"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dashboard":{"get":{"summary":"Dashboard Json","description":"Aggregate MCP usage stats across all servers.","operationId":"dashboard_json_dashboard_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","description":"Number of days to aggregate","default":30,"title":"Days"},"description":"Number of days to aggregate"},{"name":"token","in":"query","required":false,"schema":{"type":"string","description":"Access token","default":"","title":"Token"},"description":"Access token"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dashboard/view":{"get":{"summary":"Dashboard Html","description":"Shareable HTML dashboard proving MCP servers are in use.","operationId":"dashboard_html_dashboard_view_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","description":"Number of days to aggregate","default":30,"title":"Days"},"description":"Number of days to aggregate"},{"name":"token","in":"query","required":false,"schema":{"type":"string","description":"Access token","default":"","title":"Token"},"description":"Access token"}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/audit":{"get":{"summary":"Gap Analysis All","description":"Gap analysis for all businesses — comparative scorecard.","operationId":"gap_analysis_all_audit_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}