{"openapi":"3.0.3","info":{"title":"Match with Care public agent contract","version":"1.0.0","description":"Read-only discovery contract for AI agents. First action: What are the main types of home care in the UK? Success: Sourced cards for visiting, live-in, overnight, respite, and companionship care. No account, no payment. Capability surface: MCP at https://mcp.matchwithcare.co.uk/mcp (tool matchwithcare.get_home_care_types). HTML destination: https://matchwithcare.co.uk/care-types/visiting-care. This document does not describe authenticated family, carer, admin, or payment APIs. Those require a human Clerk session and are out of scope for agents.","contact":{"name":"Match with Care","email":"hello@matchwithcare.com","url":"https://matchwithcare.co.uk/for-agents"}},"externalDocs":{"description":"For AI assistants","url":"https://matchwithcare.co.uk/for-agents"},"servers":[{"url":"https://matchwithcare.co.uk","description":"Production"}],"security":[],"tags":[{"name":"Discovery","description":"Machine-readable agent discovery documents"},{"name":"Guides","description":"Read-only human destinations for the first action"}],"paths":{"/openapi.json":{"get":{"tags":["Discovery"],"summary":"This OpenAPI document","operationId":"getPublicOpenApi","responses":{"200":{"description":"Public OpenAPI 3 document","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/for-agents":{"get":{"tags":["Discovery"],"summary":"Human-readable agent contract","operationId":"getForAgentsPage","responses":{"200":{"description":"Setup, verification, rollback, and first-action documentation","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/.well-known/mcp/server-card.json":{"get":{"tags":["Discovery"],"summary":"MCP server card","operationId":"getMcpServerCard","responses":{"200":{"description":"MCP server card pointing at the Streamable HTTP endpoint","content":{"application/mcp-server-card+json":{"schema":{"type":"object"}}}}}}},"/.well-known/mcp/catalog.json":{"get":{"tags":["Discovery"],"summary":"MCP catalog","operationId":"getMcpCatalog","responses":{"200":{"description":"Catalog of MCP server cards on this origin","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/mcp.json":{"get":{"tags":["Discovery"],"summary":"MCP discovery alias","operationId":"getMcpWellKnownAlias","responses":{"200":{"description":"Compact MCP discovery document","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/oauth-protected-resource":{"get":{"tags":["Discovery"],"summary":"Protected-resource metadata","operationId":"getOAuthProtectedResource","description":"The public agent surface does not require OAuth. Clerk-protected APIs are not part of this contract.","responses":{"200":{"description":"RFC 9728 metadata for the public agent resource","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/api-catalog":{"get":{"tags":["Discovery"],"summary":"API catalog","operationId":"getApiCatalog","responses":{"200":{"description":"RFC 9727 linkset of public agent documents","content":{"application/linkset+json":{"schema":{"type":"object"}}}}}}},"/care-types/visiting-care":{"get":{"tags":["Guides"],"summary":"HTML first-action destination","operationId":"getVisitingCareGuide","description":"Sourced cards for visiting, live-in, overnight, respite, and companionship care. No account, no payment.","responses":{"200":{"description":"Public visiting-care guide page","content":{"text/html":{"schema":{"type":"string"}}}}}}}}}