{"openapi":"3.1.0","info":{"title":"MTC Evidence API","version":"0.1.0","description":"Get a published medical-procedure price corridor with source provenance, dataset version, fact hash, and an offline-verifiable Ed25519 service signature. Published price information only; not medical or purchase advice."},"servers":[{"url":"https://agent-fact-receipts-staging.131313122.workers.dev"}],"paths":{"/mcp":{"post":{"operationId":"call_mtc_mcp","summary":"Stateless Streamable HTTP MCP endpoint for agent discovery and demand.","responses":{"200":{"description":"MCP JSON-RPC response"},"202":{"description":"MCP notification accepted"}}}},"/v1/catalog":{"get":{"operationId":"list_evidence_products","summary":"List purchasable, inventory-building, and planned evidence products.","responses":{"200":{"description":"Versioned machine-shop catalog"}}}},"/v1/inventory":{"get":{"operationId":"list_purchasable_evidence_inventory","summary":"List purchasable facts and exact query parameters without exposing paid values.","responses":{"200":{"description":"Versioned purchasable inventory index"}}}},"/v1/products/{productId}":{"get":{"operationId":"get_evidence_product","parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product readiness and delivery contract"},"404":{"description":"Unknown product"}}}},"/health":{"get":{"operationId":"health","responses":{"200":{"description":"Service health"}}}},"/v1/demo":{"get":{"operationId":"get_demo_receipt","responses":{"200":{"description":"Fixed signed sample receipt"}}}},"/v1/demand/probe":{"get":{"operationId":"get_demand_probe_contract","summary":"Read accepted tasks, fields, privacy boundary, and availability status.","responses":{"200":{"description":"Demand-probe contract"}}},"post":{"operationId":"probe_medical_travel_task","summary":"Record a structured non-personal evidence job without sending patient data or receiving paid values.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["jobType","buyerClass"],"properties":{"jobType":{"type":"string","enum":["plan_treatment_budget","compare_treatment_options","medical_travel_data_feed","find_matching_provider_evidence","sync_price_changes","check_medical_quote"]},"buyerClass":{"type":"string","enum":["assistant","planner","integrator","insurer","provider","researcher","other"]},"procedure":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,79}$"},"originCountry":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,79}$"},"destinationCountries":{"type":"array","maxItems":3,"items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,79}$"}},"freshness":{"type":"string","enum":["current_30d","current_90d","latest_available"]},"outputType":{"type":"string","enum":["single_call","dataset","change_feed","integration"]},"channel":{"type":"string","enum":["direct","bazaar","mcp","mtc","other"]}}},"examples":{"plan_treatment_budget":{"summary":"Plan a treatment-travel budget","description":"Record demand for an origin-aware treatment-trip budget that separates published treatment evidence from modeled travel costs.","value":{"jobType":"plan_treatment_budget","buyerClass":"planner","procedure":"dental-implants","originCountry":"united-kingdom","destinationCountries":["turkey","hungary"],"freshness":"current_90d","outputType":"single_call","channel":"direct"}},"compare_treatment_options":{"summary":"Compare treatment options","description":"Record demand for a like-for-like comparison of destination price evidence, price basis, inclusions, freshness, and sources.","value":{"jobType":"compare_treatment_options","buyerClass":"assistant","procedure":"hair-transplant","destinationCountries":["turkey","thailand"],"freshness":"latest_available","outputType":"single_call","channel":"direct"}},"medical_travel_data_feed":{"summary":"Integrate a medical-travel evidence feed","description":"Record demand for normalized, licensed medical-travel price evidence for an AI product or other software integration.","value":{"jobType":"medical_travel_data_feed","buyerClass":"integrator","procedure":"ivf","destinationCountries":["spain","greece","czech-republic"],"freshness":"current_30d","outputType":"integration","channel":"direct"}},"find_matching_provider_evidence":{"summary":"Find matching provider evidence","description":"Record demand for an evidence-filtered provider shortlist based on published capabilities, packages, and official credentials; not a clinical ranking.","value":{"jobType":"find_matching_provider_evidence","buyerClass":"assistant","procedure":"lasik","destinationCountries":["malaysia"],"freshness":"current_90d","outputType":"single_call","channel":"direct"}},"sync_price_changes":{"summary":"Sync medical price changes","description":"Record demand for a delta feed identifying changed, stale, or disappeared published price and package evidence.","value":{"jobType":"sync_price_changes","buyerClass":"integrator","procedure":"rhinoplasty","destinationCountries":["turkey"],"freshness":"current_30d","outputType":"change_feed","channel":"direct"}},"check_medical_quote":{"summary":"Check a medical quote against published evidence","description":"Record demand for a structured, non-identifying quote-versus-published-evidence check. Never submit documents, narrative text, or patient data.","value":{"jobType":"check_medical_quote","buyerClass":"assistant","procedure":"bariatric-surgery","destinationCountries":["mexico"],"freshness":"latest_available","outputType":"single_call","channel":"direct"}}}}}},"x-agent-jobs":[{"jobType":"plan_treatment_budget","title":"Plan a treatment-travel budget","request":"Record demand for an origin-aware treatment-trip budget that separates published treatment evidence from modeled travel costs.","example":{"jobType":"plan_treatment_budget","buyerClass":"planner","procedure":"dental-implants","originCountry":"united-kingdom","destinationCountries":["turkey","hungary"],"freshness":"current_90d","outputType":"single_call","channel":"direct"}},{"jobType":"compare_treatment_options","title":"Compare treatment options","request":"Record demand for a like-for-like comparison of destination price evidence, price basis, inclusions, freshness, and sources.","example":{"jobType":"compare_treatment_options","buyerClass":"assistant","procedure":"hair-transplant","destinationCountries":["turkey","thailand"],"freshness":"latest_available","outputType":"single_call","channel":"direct"}},{"jobType":"medical_travel_data_feed","title":"Integrate a medical-travel evidence feed","request":"Record demand for normalized, licensed medical-travel price evidence for an AI product or other software integration.","example":{"jobType":"medical_travel_data_feed","buyerClass":"integrator","procedure":"ivf","destinationCountries":["spain","greece","czech-republic"],"freshness":"current_30d","outputType":"integration","channel":"direct"}},{"jobType":"find_matching_provider_evidence","title":"Find matching provider evidence","request":"Record demand for an evidence-filtered provider shortlist based on published capabilities, packages, and official credentials; not a clinical ranking.","example":{"jobType":"find_matching_provider_evidence","buyerClass":"assistant","procedure":"lasik","destinationCountries":["malaysia"],"freshness":"current_90d","outputType":"single_call","channel":"direct"}},{"jobType":"sync_price_changes","title":"Sync medical price changes","request":"Record demand for a delta feed identifying changed, stale, or disappeared published price and package evidence.","example":{"jobType":"sync_price_changes","buyerClass":"integrator","procedure":"rhinoplasty","destinationCountries":["turkey"],"freshness":"current_30d","outputType":"change_feed","channel":"direct"}},{"jobType":"check_medical_quote","title":"Check a medical quote against published evidence","request":"Record demand for a structured, non-identifying quote-versus-published-evidence check. Never submit documents, narrative text, or patient data.","example":{"jobType":"check_medical_quote","buyerClass":"assistant","procedure":"bariatric-surgery","destinationCountries":["mexico"],"freshness":"latest_available","outputType":"single_call","channel":"direct"}}],"responses":{"200":{"description":"Probe recorded with research-only capability status"},"400":{"description":"Invalid or prohibited input"}}}},"/v1/price-corridor":{"get":{"operationId":"get_price_corridor","summary":"Get a published medical-procedure price corridor with source provenance, dataset version, fact hash, and an offline-verifiable Ed25519 service signature. Published price information only; not medical or purchase advice.","parameters":[{"name":"procedure","in":"query","required":true,"schema":{"type":"string"}},{"name":"city","in":"query","required":true,"schema":{"type":"string"}},{"name":"country","in":"query","required":true,"schema":{"type":"string"}},{"name":"provider","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Signed evidence receipt after x402 payment"},"402":{"description":"x402 payment required"}}}},"/v1/verify-receipt":{"post":{"operationId":"verify_fact_receipt","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Receipt verification result"}}}}}}