{"openapi":"3.1.0","info":{"title":"UK Premises Licence Preflight HTTP API","version":"1.0.0","description":"HTTP compatibility surface for the same deterministic, evidence-linked premises-licence decision engine exposed over MCP. Free readiness/status routes remain unmetered; POST /api/v1/preflight and /api/v1/compare are x402 protected.","x-mcp":{"endpoint":"https://uk-premises-licence-mcp-production.up.railway.app/mcp","transport":"streamable-http","protocolVersion":"2026-07-28","serverCard":"https://uk-premises-licence-mcp-production.up.railway.app/mcp/server-card","paidTools":{"premises_licence_preflight":"$0.03","compare_licensing_requirements":"$0.05"}}},"servers":[{"url":"https://uk-premises-licence-mcp-production.up.railway.app"}],"paths":{"/local-policy-capabilities":{"get":{"operationId":"premises-local-policy-capabilities","summary":"Inspect encoded local policy capabilities before a paid decision.","parameters":[{"name":"authority","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Authority capability metadata."}}}},"/preflight-readiness":{"post":{"operationId":"premises-preflight-readiness","summary":"Check evidence readiness and missing facts before spending x402 USDC.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"authority":{"type":"string"},"provided_facts":{"type":"object","additionalProperties":true}},"required":["authority"],"additionalProperties":false}}}},"responses":{"200":{"description":"Readiness and missing-fact result."},"400":{"description":"Invalid request."}}}},"/status":{"get":{"operationId":"premises-service-status","summary":"Decision-aware source/runtime status.","responses":{"200":{"description":"Bounded operational status."}}}},"/version":{"get":{"operationId":"premises-service-version","summary":"Deployed service version and commit identity when available.","responses":{"200":{"description":"Version metadata."}}}},"/metrics":{"get":{"operationId":"premises-service-metrics","summary":"Privacy-minimal aggregate MCP/x402 counters.","responses":{"200":{"description":"Aggregate-only usage and conversion metrics."}}}},"/runtime-source-probe-status":{"get":{"operationId":"premises-runtime-source-probe-status","summary":"Latest Railway-hosted official-source probe receipt.","responses":{"200":{"description":"Runtime source-probe state."}}}},"/mcp/server-card":{"get":{"operationId":"premises-mcp-server-card","summary":"Experimental MCP Server Card for remote pre-connection discovery.","responses":{"200":{"description":"MCP Server Card."}}}},"/.well-known/ai-catalog.json":{"get":{"operationId":"premises-ai-catalog","summary":"Site-wide AI Catalog pointing to the MCP Server Card.","responses":{"200":{"description":"AI Catalog."}}}},"/api/v1/preflight":{"post":{"operationId":"uk-premises-licence-preflight","summary":"Paid evidence-linked premises-licence preflight","description":"Run the same deterministic, fail-closed decision pipeline as the paid MCP tool. Payment verification precedes execution; current official evidence is still required.","tags":["premises-licence","regulatory","x402"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"authority":{"type":"string","description":"Supported UK local licensing authority."},"applicant_age":{"type":"integer","minimum":0}},"required":["authority","applicant_age"],"additionalProperties":true},"example":{"authority":"Westminster City Council","applicant_age":30,"sells_alcohol":true}}}},"responses":{"200":{"description":"Evidence-linked deterministic preflight result."},"402":{"description":"Payment Required. Inspect the runtime x402 v2 PAYMENT-REQUIRED header for the authoritative chain, asset, amount and payment requirements."},"422":{"description":"Invalid request."}}}},"/api/v1/compare":{"post":{"operationId":"uk-premises-licensing-compare","summary":"Paid cross-authority premises-licensing comparison","description":"Compare the same proposed premises facts across supported authorities. Each authority remains independently evidence/freshness guarded.","tags":["premises-licence","comparison","x402"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"authorities":{"type":"array","items":{"type":"string"},"minItems":2,"description":"Supported local licensing authorities to compare."},"applicant_age":{"type":"integer","minimum":0}},"required":["authorities","applicant_age"],"additionalProperties":true},"example":{"authorities":["Westminster City Council","Camden Council"],"applicant_age":30,"sells_alcohol":true}}}},"responses":{"200":{"description":"Evidence-linked cross-authority comparison."},"402":{"description":"Payment Required. Inspect the runtime x402 v2 PAYMENT-REQUIRED header for the authoritative chain, asset, amount and payment requirements."},"422":{"description":"Invalid request."}}}}}}