{"openapi":"3.1.0","info":{"title":"MCI Scout declared constraint comparison","version":"2.0.0","description":"Additive stateless comparison of eight documented route-specific web-search offers. Eligible means all required declared checks pass; it is not provider selection, verified execution or spending authority."},"servers":[{"url":"https://mci-encounter-lab.az01.chatgpt.site"}],"security":[],"paths":{"/v2/scout/compare":{"post":{"operationId":"compareDeclaredScoutConstraintsV2","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareRequest"},"example":{"schema_version":"2","capability":"web_search","input_type":"text_query","workload":{"unit":"request","quantity":20},"output":{"format":"json","required_fields":["results[].url"]},"max_results_per_request":10,"ai_summary":false,"payment":{"rail":"provider_account"},"budget":{"scope":"incremental_list_price","currency":"USD","max_amount":"0.15"},"quality":{"require_observed_success":false}}}}},"responses":{"200":{"description":"Evaluated offers separated into eligible, review and rejected; every check has supported/mismatch/unknown state and a reason.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareResult"}}}},"400":{"description":"The error field contains a stable rejection code.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"403":{"description":"The error field contains a stable rejection code.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"413":{"description":"The error field contains a stable rejection code.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"415":{"description":"The error field contains a stable rejection code.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}}},"components":{"schemas":{"CompareRequest":{"type":"object","additionalProperties":false,"required":["schema_version","capability","input_type","workload","output","max_results_per_request","ai_summary","payment"],"properties":{"schema_version":{"const":"2"},"capability":{"type":"string","minLength":1,"maxLength":120,"description":"Exact semantic capability. This bounded snapshot supports web_search; other capabilities are mismatches."},"input_type":{"type":"string","minLength":1,"maxLength":40,"description":"Declared input contract, such as text_query; no private query is submitted."},"workload":{"type":"object","additionalProperties":false,"required":["unit","quantity"],"properties":{"unit":{"type":"string","minLength":1,"maxLength":40,"description":"request means independent API calls. Other units require unknown conversion."},"quantity":{"type":"integer","minimum":1,"maximum":100000}}},"output":{"type":"object","additionalProperties":false,"required":["format"],"properties":{"format":{"type":"string","minLength":1,"maxLength":30,"description":"Native response format; json is documented. No adapter is supplied."},"required_fields":{"type":"array","maxItems":8,"uniqueItems":true,"items":{"type":"string","maxLength":80,"pattern":"^[a-zA-Z][a-zA-Z0-9_]*(?:\\[\\])?(?:\\.[a-zA-Z][a-zA-Z0-9_]*(?:\\[\\])?)*$"}}}},"max_results_per_request":{"type":"integer","minimum":1,"maximum":1000,"description":"Requested maximum, not a guaranteed useful-result count."},"ai_summary":{"type":"boolean","description":"True remains review-only because complete summary billing quantity/contract is not modeled."},"payment":{"type":"object","additionalProperties":false,"required":["rail"],"properties":{"rail":{"type":"string","enum":["provider_account","x402"]},"network":{"type":"string","minLength":1,"maxLength":120},"asset":{"type":"string","minLength":1,"maxLength":160}},"oneOf":[{"properties":{"rail":{"const":"provider_account"}},"not":{"anyOf":[{"required":["network"]},{"required":["asset"]}]}},{"properties":{"rail":{"const":"x402"}},"required":["network","asset"]}]},"budget":{"type":["object","null"],"additionalProperties":false,"required":["scope","currency"],"oneOf":[{"type":"null"},{"type":"object","required":["max_amount"],"not":{"required":["max_amount_atomic"]}},{"type":"object","required":["max_amount_atomic"],"not":{"required":["max_amount"]}}],"description":"Explicit budget scope. Incremental list price excludes entry cash, taxes and account terms. Total cash outlay is not established and remains review-only.","properties":{"scope":{"type":"string","enum":["incremental_list_price","total_cash_outlay"]},"currency":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{1,11}$","description":"USD is the provider-account price currency. USDC is separately documented for native x402 offers; they are never equated."},"max_amount":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$","description":"Exact nonnegative decimal currency units; not blockchain atomic units."},"max_amount_atomic":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,23})$","description":"Native asset atomic units, comparable only when currency, network, asset and atomic price evidence match."}}},"quality":{"type":"object","additionalProperties":false,"required":["require_observed_success"],"properties":{"require_observed_success":{"type":"boolean","default":true,"description":"Defaults true, which keeps all untested offers in review. False explicitly removes observed-quality success from required eligibility checks; quality remains unassessed."}}}}},"CompareResult":{"type":"object","required":["schema_version","request","status","eligible","review","rejected","counts","stored","no_provider_execution","no_payment"],"properties":{"schema_version":{"const":"2"},"request":{"$ref":"#/components/schemas/CompareRequest"},"status":{"type":"string","enum":["declared_eligible_offers","needs_review","no_eligible_offer"]},"eligible":{"type":"array","items":{"$ref":"#/components/schemas/OfferEvaluation"}},"review":{"type":"array","items":{"$ref":"#/components/schemas/OfferEvaluation"}},"rejected":{"type":"array","items":{"$ref":"#/components/schemas/OfferEvaluation"}},"counts":{"type":"object"},"stored":{"const":false},"no_provider_execution":{"const":true},"no_payment":{"const":true}}},"OfferEvaluation":{"type":"object","required":["offer_id","group","reasons","checks","cost","declared_contract","quality_status"],"properties":{"offer_id":{"type":"string"},"group":{"type":"string","enum":["eligible","review","rejected"]},"reasons":{"type":"array","items":{"type":"object"}},"checks":{"type":"array","items":{"type":"object","required":["constraint","status","reason","required"],"properties":{"constraint":{"type":"string"},"status":{"type":"string","enum":["supported","mismatch","unknown"]},"reason":{"type":"string"},"required":{"type":"boolean"},"source_url":{"type":["string","null"]},"evidence_kind":{"type":"string"}}}},"cost":{"type":"object"},"declared_contract":{"type":"object"},"quality_status":{"const":"not_established"}}}}}}