{"openapi":"3.1.0","info":{"title":"El Nino Wiki Heat-Risk API","version":"1.0.0","description":"A deterministic heat-risk assessment service for Europe and USA city baselines or caller-supplied weather conditions. It returns a transparent risk score, peak-risk window, contributing factors, and tier-specific safety actions.","contact":{"email":"support@elnino.wiki"},"x-guidance":"Discover schemas and prices here, treat runtime 402 challenges as authoritative, use an Idempotency-Key for paid calls, and return the payment receipt with the result.","x-pricing":{"preview":{"enabled":true,"price_usd":0.02,"result":"Risk score, status, peak window, and two priority actions."},"standard":{"enabled":true,"price_usd":1,"result":"Full factor attribution and an actionable heat-safety briefing."},"premium":{"enabled":true,"price_usd":3,"result":"Exposure-sensitive briefing with a time-window plan for people, work, travel, or events."}},"x-payment-protocols":["x402","mpp"]},"servers":[{"url":"https://elnino.wiki","description":"Canonical production origin"},{"url":"https://x402.elnino.wiki","description":"x402 production origin"},{"url":"https://mpp.elnino.wiki","description":"MPP production origin"}],"security":[],"externalDocs":{"description":"Human and agent integration guide","url":"https://elnino.wiki/docs"},"x-service-info":{"categories":["weather","risk-assessment","travel","worker-safety"],"docs":{"homepage":"https://elnino.wiki","apiReference":"https://elnino.wiki/docs","quickstart":"https://elnino.wiki/docs/quickstart.md","payments":"https://elnino.wiki/docs/payments.md","llms":"https://elnino.wiki/llms.txt"}},"paths":{"/api/health":{"get":{"operationId":"getHealth","summary":"Health and payment readiness","tags":["Free"],"security":[],"responses":{"200":{"description":"Service is reachable","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/services":{"get":{"operationId":"listServices","summary":"Machine-readable service catalog","description":"Canonical catalog of capabilities, input schemas, prices, currencies, networks, and payment endpoints.","tags":["Free"],"security":[],"responses":{"200":{"description":"Public service catalog","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/preview":{"post":{"operationId":"previewHeatRisk","summary":"Rate-limited browser preview","description":"A deliberately limited anonymous preview. Agents should use a paid preview route after the published limit.","tags":["Limited"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tier"],"properties":{"tier":{"type":"string","enum":["preview","standard","premium"],"description":"Depth of the requested briefing."},"city_slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9-]+$","description":"Supported city slug such as paris, phoenix, or new-york."},"conditions":{"type":"object","additionalProperties":false,"required":["label","temperature_c","feels_like_c","humidity_percent","uv_index","wind_kph","overnight_low_c"],"properties":{"label":{"type":"string","minLength":2,"maxLength":120},"temperature_c":{"type":"number","minimum":-20,"maximum":60},"feels_like_c":{"type":"number","minimum":-30,"maximum":70},"humidity_percent":{"type":"number","minimum":0,"maximum":100},"uv_index":{"type":"number","minimum":0,"maximum":20},"wind_kph":{"type":"number","minimum":0,"maximum":200},"overnight_low_c":{"type":"number","minimum":-30,"maximum":50},"peak_window":{"type":"string","minLength":3,"maxLength":40}}},"exposure":{"type":"object","additionalProperties":false,"properties":{"exertion":{"type":"string","enum":["low","moderate","high"]},"shade":{"type":"string","enum":["none","partial","full"]},"duration_minutes":{"type":"integer","minimum":10,"maximum":720},"vulnerable_person":{"type":"boolean"},"start_local":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"oneOf":[{"required":["city_slug"],"not":{"required":["conditions"]}},{"required":["conditions"],"not":{"required":["city_slug"]}}]},"examples":{"city":{"value":{"tier":"standard","city_slug":"phoenix","exposure":{"exertion":"moderate","shade":"partial","duration_minutes":90}}},"conditions":{"value":{"tier":"standard","conditions":{"label":"Madrid outdoor work","temperature_c":38,"feels_like_c":41,"humidity_percent":31,"uv_index":10,"wind_kph":9,"overnight_low_c":25,"peak_window":"13:00-20:00"},"exposure":{"exertion":"high","shade":"none","duration_minutes":120}}}}}}},"responses":{"200":{"description":"Compact heat-risk preview","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","additionalProperties":false,"required":["request_id","tier","location","risk_score","status","peak_window","summary","factors","recommendations","provenance","disclaimer"],"properties":{"request_id":{"type":"string"},"tier":{"type":"string","enum":["preview","standard","premium"]},"location":{"type":"string"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"status":{"type":"string","enum":["Safe","Warm","Caution","Danger","El Nino Mode"]},"peak_window":{"type":"string"},"summary":{"type":"string"},"factors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","impact","evidence"],"properties":{"name":{"type":"string"},"impact":{"type":"string","enum":["lowers-risk","neutral","raises-risk","major-driver"]},"evidence":{"type":"string"}}}},"recommendations":{"type":"array","minItems":1,"items":{"type":"string"}},"schedule":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["window","guidance"],"properties":{"window":{"type":"string"},"guidance":{"type":"string"}}}},"provenance":{"type":"object","additionalProperties":false,"required":["source_type","freshness"],"properties":{"source_type":{"type":"string","enum":["published-city-baseline","caller-supplied-conditions"]},"freshness":{"type":"string"}}},"disclaimer":{"type":"string"}}},"access":{"type":"object"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}},"429":{"description":"Preview rate limit reached","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}}}}},"/api/v1/execute":{"post":{"operationId":"quoteHeatRiskExecution","summary":"Validate input and select a payment protocol","tags":["Payment"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tier"],"properties":{"tier":{"type":"string","enum":["preview","standard","premium"],"description":"Depth of the requested briefing."},"city_slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9-]+$","description":"Supported city slug such as paris, phoenix, or new-york."},"conditions":{"type":"object","additionalProperties":false,"required":["label","temperature_c","feels_like_c","humidity_percent","uv_index","wind_kph","overnight_low_c"],"properties":{"label":{"type":"string","minLength":2,"maxLength":120},"temperature_c":{"type":"number","minimum":-20,"maximum":60},"feels_like_c":{"type":"number","minimum":-30,"maximum":70},"humidity_percent":{"type":"number","minimum":0,"maximum":100},"uv_index":{"type":"number","minimum":0,"maximum":20},"wind_kph":{"type":"number","minimum":0,"maximum":200},"overnight_low_c":{"type":"number","minimum":-30,"maximum":50},"peak_window":{"type":"string","minLength":3,"maxLength":40}}},"exposure":{"type":"object","additionalProperties":false,"properties":{"exertion":{"type":"string","enum":["low","moderate","high"]},"shade":{"type":"string","enum":["none","partial","full"]},"duration_minutes":{"type":"integer","minimum":10,"maximum":720},"vulnerable_person":{"type":"boolean"},"start_local":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"oneOf":[{"required":["city_slug"],"not":{"required":["conditions"]}},{"required":["conditions"],"not":{"required":["city_slug"]}}]},"examples":{"city":{"value":{"tier":"standard","city_slug":"phoenix","exposure":{"exertion":"moderate","shade":"partial","duration_minutes":90}}},"conditions":{"value":{"tier":"standard","conditions":{"label":"Madrid outdoor work","temperature_c":38,"feels_like_c":41,"humidity_percent":31,"uv_index":10,"wind_kph":9,"overnight_low_c":25,"peak_window":"13:00-20:00"},"exposure":{"exertion":"high","shade":"none","duration_minutes":120}}}}}}},"responses":{"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}},"402":{"description":"Choose x402 or MPP","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}},"503":{"description":"Operator payment configuration is not ready","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}}}}},"/api/x402/v1/preview":{"post":{"operationId":"x402PreviewHeatRisk","summary":"Preview heat-risk briefing via x402","tags":["x402"],"security":[{"X402Payment":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"8 to 128 URL-safe characters. Reuse only when retrying the same paid operation.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._~-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tier"],"properties":{"tier":{"type":"string","enum":["preview","standard","premium"],"description":"Depth of the requested briefing."},"city_slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9-]+$","description":"Supported city slug such as paris, phoenix, or new-york."},"conditions":{"type":"object","additionalProperties":false,"required":["label","temperature_c","feels_like_c","humidity_percent","uv_index","wind_kph","overnight_low_c"],"properties":{"label":{"type":"string","minLength":2,"maxLength":120},"temperature_c":{"type":"number","minimum":-20,"maximum":60},"feels_like_c":{"type":"number","minimum":-30,"maximum":70},"humidity_percent":{"type":"number","minimum":0,"maximum":100},"uv_index":{"type":"number","minimum":0,"maximum":20},"wind_kph":{"type":"number","minimum":0,"maximum":200},"overnight_low_c":{"type":"number","minimum":-30,"maximum":50},"peak_window":{"type":"string","minLength":3,"maxLength":40}}},"exposure":{"type":"object","additionalProperties":false,"properties":{"exertion":{"type":"string","enum":["low","moderate","high"]},"shade":{"type":"string","enum":["none","partial","full"]},"duration_minutes":{"type":"integer","minimum":10,"maximum":720},"vulnerable_person":{"type":"boolean"},"start_local":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"oneOf":[{"required":["city_slug"],"not":{"required":["conditions"]}},{"required":["conditions"],"not":{"required":["city_slug"]}}]},"examples":{"city":{"value":{"tier":"standard","city_slug":"phoenix","exposure":{"exertion":"moderate","shade":"partial","duration_minutes":90}}},"conditions":{"value":{"tier":"standard","conditions":{"label":"Madrid outdoor work","temperature_c":38,"feels_like_c":41,"humidity_percent":31,"uv_index":10,"wind_kph":9,"overnight_low_c":25,"peak_window":"13:00-20:00"},"exposure":{"exertion":"high","shade":"none","duration_minutes":120}}}}}}},"x-pricing":{"tier":"preview","price_usd":0.02},"x-x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitator":"https://facilitator.payai.network","resource":"https://x402.elnino.wiki/api/x402/v1/preview","method":"POST","mimeType":"application/json","discovery":"Bazaar metadata is declared in each runtime 402 challenge."},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["result","payment","idempotent_replay"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["request_id","tier","location","risk_score","status","peak_window","summary","factors","recommendations","provenance","disclaimer"],"properties":{"request_id":{"type":"string"},"tier":{"type":"string","enum":["preview","standard","premium"]},"location":{"type":"string"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"status":{"type":"string","enum":["Safe","Warm","Caution","Danger","El Nino Mode"]},"peak_window":{"type":"string"},"summary":{"type":"string"},"factors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","impact","evidence"],"properties":{"name":{"type":"string"},"impact":{"type":"string","enum":["lowers-risk","neutral","raises-risk","major-driver"]},"evidence":{"type":"string"}}}},"recommendations":{"type":"array","minItems":1,"items":{"type":"string"}},"schedule":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["window","guidance"],"properties":{"window":{"type":"string"},"guidance":{"type":"string"}}}},"provenance":{"type":"object","additionalProperties":false,"required":["source_type","freshness"],"properties":{"source_type":{"type":"string","enum":["published-city-baseline","caller-supplied-conditions"]},"freshness":{"type":"string"}}},"disclaimer":{"type":"string"}}},"payment":{"type":"object","additionalProperties":false,"required":["protocol","reference","receipt_header","amount_usd","currency","receiver"],"properties":{"protocol":{"type":"string","enum":["x402","mpp"]},"reference":{"type":"string"},"receipt_header":{"type":"string","enum":["PAYMENT-RESPONSE","Payment-Receipt"]},"amount_usd":{"type":"number"},"currency":{"type":"string"},"receiver":{"type":"string"}}},"idempotent_replay":{"type":"boolean"}}}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 settlement response containing the transaction reference","schema":{"type":"string"}}}},"400":{"description":"Invalid input or idempotency key","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}},"402":{"description":"x402 Payment Required","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}},"headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements","schema":{"type":"string"}}}},"503":{"description":"Operator payment configuration is not ready","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}}}}},"/api/x402/v1/execute":{"post":{"operationId":"x402StandardHeatRisk","summary":"Standard heat-risk briefing via x402","tags":["x402"],"security":[{"X402Payment":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"8 to 128 URL-safe characters. Reuse only when retrying the same paid operation.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._~-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tier"],"properties":{"tier":{"type":"string","enum":["preview","standard","premium"],"description":"Depth of the requested briefing."},"city_slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9-]+$","description":"Supported city slug such as paris, phoenix, or new-york."},"conditions":{"type":"object","additionalProperties":false,"required":["label","temperature_c","feels_like_c","humidity_percent","uv_index","wind_kph","overnight_low_c"],"properties":{"label":{"type":"string","minLength":2,"maxLength":120},"temperature_c":{"type":"number","minimum":-20,"maximum":60},"feels_like_c":{"type":"number","minimum":-30,"maximum":70},"humidity_percent":{"type":"number","minimum":0,"maximum":100},"uv_index":{"type":"number","minimum":0,"maximum":20},"wind_kph":{"type":"number","minimum":0,"maximum":200},"overnight_low_c":{"type":"number","minimum":-30,"maximum":50},"peak_window":{"type":"string","minLength":3,"maxLength":40}}},"exposure":{"type":"object","additionalProperties":false,"properties":{"exertion":{"type":"string","enum":["low","moderate","high"]},"shade":{"type":"string","enum":["none","partial","full"]},"duration_minutes":{"type":"integer","minimum":10,"maximum":720},"vulnerable_person":{"type":"boolean"},"start_local":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"oneOf":[{"required":["city_slug"],"not":{"required":["conditions"]}},{"required":["conditions"],"not":{"required":["city_slug"]}}]},"examples":{"city":{"value":{"tier":"standard","city_slug":"phoenix","exposure":{"exertion":"moderate","shade":"partial","duration_minutes":90}}},"conditions":{"value":{"tier":"standard","conditions":{"label":"Madrid outdoor work","temperature_c":38,"feels_like_c":41,"humidity_percent":31,"uv_index":10,"wind_kph":9,"overnight_low_c":25,"peak_window":"13:00-20:00"},"exposure":{"exertion":"high","shade":"none","duration_minutes":120}}}}}}},"x-pricing":{"tier":"standard","price_usd":1},"x-x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitator":"https://facilitator.payai.network","resource":"https://x402.elnino.wiki/api/x402/v1/execute","method":"POST","mimeType":"application/json","discovery":"Bazaar metadata is declared in each runtime 402 challenge."},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["result","payment","idempotent_replay"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["request_id","tier","location","risk_score","status","peak_window","summary","factors","recommendations","provenance","disclaimer"],"properties":{"request_id":{"type":"string"},"tier":{"type":"string","enum":["preview","standard","premium"]},"location":{"type":"string"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"status":{"type":"string","enum":["Safe","Warm","Caution","Danger","El Nino Mode"]},"peak_window":{"type":"string"},"summary":{"type":"string"},"factors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","impact","evidence"],"properties":{"name":{"type":"string"},"impact":{"type":"string","enum":["lowers-risk","neutral","raises-risk","major-driver"]},"evidence":{"type":"string"}}}},"recommendations":{"type":"array","minItems":1,"items":{"type":"string"}},"schedule":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["window","guidance"],"properties":{"window":{"type":"string"},"guidance":{"type":"string"}}}},"provenance":{"type":"object","additionalProperties":false,"required":["source_type","freshness"],"properties":{"source_type":{"type":"string","enum":["published-city-baseline","caller-supplied-conditions"]},"freshness":{"type":"string"}}},"disclaimer":{"type":"string"}}},"payment":{"type":"object","additionalProperties":false,"required":["protocol","reference","receipt_header","amount_usd","currency","receiver"],"properties":{"protocol":{"type":"string","enum":["x402","mpp"]},"reference":{"type":"string"},"receipt_header":{"type":"string","enum":["PAYMENT-RESPONSE","Payment-Receipt"]},"amount_usd":{"type":"number"},"currency":{"type":"string"},"receiver":{"type":"string"}}},"idempotent_replay":{"type":"boolean"}}}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 settlement response containing the transaction reference","schema":{"type":"string"}}}},"400":{"description":"Invalid input or idempotency key","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}},"402":{"description":"x402 Payment Required","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}},"headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements","schema":{"type":"string"}}}},"503":{"description":"Operator payment configuration is not ready","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}}}}},"/api/x402/v1/premium":{"post":{"operationId":"x402PremiumHeatRisk","summary":"Premium heat-risk briefing via x402","tags":["x402"],"security":[{"X402Payment":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"8 to 128 URL-safe characters. Reuse only when retrying the same paid operation.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._~-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tier"],"properties":{"tier":{"type":"string","enum":["preview","standard","premium"],"description":"Depth of the requested briefing."},"city_slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9-]+$","description":"Supported city slug such as paris, phoenix, or new-york."},"conditions":{"type":"object","additionalProperties":false,"required":["label","temperature_c","feels_like_c","humidity_percent","uv_index","wind_kph","overnight_low_c"],"properties":{"label":{"type":"string","minLength":2,"maxLength":120},"temperature_c":{"type":"number","minimum":-20,"maximum":60},"feels_like_c":{"type":"number","minimum":-30,"maximum":70},"humidity_percent":{"type":"number","minimum":0,"maximum":100},"uv_index":{"type":"number","minimum":0,"maximum":20},"wind_kph":{"type":"number","minimum":0,"maximum":200},"overnight_low_c":{"type":"number","minimum":-30,"maximum":50},"peak_window":{"type":"string","minLength":3,"maxLength":40}}},"exposure":{"type":"object","additionalProperties":false,"properties":{"exertion":{"type":"string","enum":["low","moderate","high"]},"shade":{"type":"string","enum":["none","partial","full"]},"duration_minutes":{"type":"integer","minimum":10,"maximum":720},"vulnerable_person":{"type":"boolean"},"start_local":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"oneOf":[{"required":["city_slug"],"not":{"required":["conditions"]}},{"required":["conditions"],"not":{"required":["city_slug"]}}]},"examples":{"city":{"value":{"tier":"standard","city_slug":"phoenix","exposure":{"exertion":"moderate","shade":"partial","duration_minutes":90}}},"conditions":{"value":{"tier":"standard","conditions":{"label":"Madrid outdoor work","temperature_c":38,"feels_like_c":41,"humidity_percent":31,"uv_index":10,"wind_kph":9,"overnight_low_c":25,"peak_window":"13:00-20:00"},"exposure":{"exertion":"high","shade":"none","duration_minutes":120}}}}}}},"x-pricing":{"tier":"premium","price_usd":3},"x-x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitator":"https://facilitator.payai.network","resource":"https://x402.elnino.wiki/api/x402/v1/premium","method":"POST","mimeType":"application/json","discovery":"Bazaar metadata is declared in each runtime 402 challenge."},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["result","payment","idempotent_replay"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["request_id","tier","location","risk_score","status","peak_window","summary","factors","recommendations","provenance","disclaimer"],"properties":{"request_id":{"type":"string"},"tier":{"type":"string","enum":["preview","standard","premium"]},"location":{"type":"string"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"status":{"type":"string","enum":["Safe","Warm","Caution","Danger","El Nino Mode"]},"peak_window":{"type":"string"},"summary":{"type":"string"},"factors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","impact","evidence"],"properties":{"name":{"type":"string"},"impact":{"type":"string","enum":["lowers-risk","neutral","raises-risk","major-driver"]},"evidence":{"type":"string"}}}},"recommendations":{"type":"array","minItems":1,"items":{"type":"string"}},"schedule":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["window","guidance"],"properties":{"window":{"type":"string"},"guidance":{"type":"string"}}}},"provenance":{"type":"object","additionalProperties":false,"required":["source_type","freshness"],"properties":{"source_type":{"type":"string","enum":["published-city-baseline","caller-supplied-conditions"]},"freshness":{"type":"string"}}},"disclaimer":{"type":"string"}}},"payment":{"type":"object","additionalProperties":false,"required":["protocol","reference","receipt_header","amount_usd","currency","receiver"],"properties":{"protocol":{"type":"string","enum":["x402","mpp"]},"reference":{"type":"string"},"receipt_header":{"type":"string","enum":["PAYMENT-RESPONSE","Payment-Receipt"]},"amount_usd":{"type":"number"},"currency":{"type":"string"},"receiver":{"type":"string"}}},"idempotent_replay":{"type":"boolean"}}}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 settlement response containing the transaction reference","schema":{"type":"string"}}}},"400":{"description":"Invalid input or idempotency key","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}},"402":{"description":"x402 Payment Required","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}},"headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements","schema":{"type":"string"}}}},"503":{"description":"Operator payment configuration is not ready","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}}}}},"/api/mpp/v1/preview":{"post":{"operationId":"mppPreviewHeatRisk","summary":"Preview heat-risk briefing via MPP","tags":["MPP"],"security":[{"MPPPayment":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"8 to 128 URL-safe characters. Reuse only when retrying the same paid operation.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._~-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tier"],"properties":{"tier":{"type":"string","enum":["preview","standard","premium"],"description":"Depth of the requested briefing."},"city_slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9-]+$","description":"Supported city slug such as paris, phoenix, or new-york."},"conditions":{"type":"object","additionalProperties":false,"required":["label","temperature_c","feels_like_c","humidity_percent","uv_index","wind_kph","overnight_low_c"],"properties":{"label":{"type":"string","minLength":2,"maxLength":120},"temperature_c":{"type":"number","minimum":-20,"maximum":60},"feels_like_c":{"type":"number","minimum":-30,"maximum":70},"humidity_percent":{"type":"number","minimum":0,"maximum":100},"uv_index":{"type":"number","minimum":0,"maximum":20},"wind_kph":{"type":"number","minimum":0,"maximum":200},"overnight_low_c":{"type":"number","minimum":-30,"maximum":50},"peak_window":{"type":"string","minLength":3,"maxLength":40}}},"exposure":{"type":"object","additionalProperties":false,"properties":{"exertion":{"type":"string","enum":["low","moderate","high"]},"shade":{"type":"string","enum":["none","partial","full"]},"duration_minutes":{"type":"integer","minimum":10,"maximum":720},"vulnerable_person":{"type":"boolean"},"start_local":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"oneOf":[{"required":["city_slug"],"not":{"required":["conditions"]}},{"required":["conditions"],"not":{"required":["city_slug"]}}]},"examples":{"city":{"value":{"tier":"standard","city_slug":"phoenix","exposure":{"exertion":"moderate","shade":"partial","duration_minutes":90}}},"conditions":{"value":{"tier":"standard","conditions":{"label":"Madrid outdoor work","temperature_c":38,"feels_like_c":41,"humidity_percent":31,"uv_index":10,"wind_kph":9,"overnight_low_c":25,"peak_window":"13:00-20:00"},"exposure":{"exertion":"high","shade":"none","duration_minutes":120}}}}}}},"x-pricing":{"tier":"preview","price_usd":0.02},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}],"offers":[{"amount":"20000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"El Nino Wiki preview heat-risk briefing","intent":"charge","method":"tempo"}]},"x-payment-network":{"name":"Tempo","chainId":4217,"origin":"https://mpp.elnino.wiki"},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["result","payment","idempotent_replay"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["request_id","tier","location","risk_score","status","peak_window","summary","factors","recommendations","provenance","disclaimer"],"properties":{"request_id":{"type":"string"},"tier":{"type":"string","enum":["preview","standard","premium"]},"location":{"type":"string"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"status":{"type":"string","enum":["Safe","Warm","Caution","Danger","El Nino Mode"]},"peak_window":{"type":"string"},"summary":{"type":"string"},"factors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","impact","evidence"],"properties":{"name":{"type":"string"},"impact":{"type":"string","enum":["lowers-risk","neutral","raises-risk","major-driver"]},"evidence":{"type":"string"}}}},"recommendations":{"type":"array","minItems":1,"items":{"type":"string"}},"schedule":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["window","guidance"],"properties":{"window":{"type":"string"},"guidance":{"type":"string"}}}},"provenance":{"type":"object","additionalProperties":false,"required":["source_type","freshness"],"properties":{"source_type":{"type":"string","enum":["published-city-baseline","caller-supplied-conditions"]},"freshness":{"type":"string"}}},"disclaimer":{"type":"string"}}},"payment":{"type":"object","additionalProperties":false,"required":["protocol","reference","receipt_header","amount_usd","currency","receiver"],"properties":{"protocol":{"type":"string","enum":["x402","mpp"]},"reference":{"type":"string"},"receipt_header":{"type":"string","enum":["PAYMENT-RESPONSE","Payment-Receipt"]},"amount_usd":{"type":"number"},"currency":{"type":"string"},"receiver":{"type":"string"}}},"idempotent_replay":{"type":"boolean"}}}}},"headers":{"Payment-Receipt":{"description":"MPP payment receipt","schema":{"type":"string"}}}},"400":{"description":"Invalid input or idempotency key","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}},"402":{"description":"MPP Payment Required","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}},"headers":{"WWW-Authenticate":{"description":"MPP Payment challenge","schema":{"type":"string"}}}},"503":{"description":"Operator payment configuration is not ready","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}}}}},"/api/mpp/v1/execute":{"post":{"operationId":"mppStandardHeatRisk","summary":"Standard heat-risk briefing via MPP","tags":["MPP"],"security":[{"MPPPayment":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"8 to 128 URL-safe characters. Reuse only when retrying the same paid operation.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._~-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tier"],"properties":{"tier":{"type":"string","enum":["preview","standard","premium"],"description":"Depth of the requested briefing."},"city_slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9-]+$","description":"Supported city slug such as paris, phoenix, or new-york."},"conditions":{"type":"object","additionalProperties":false,"required":["label","temperature_c","feels_like_c","humidity_percent","uv_index","wind_kph","overnight_low_c"],"properties":{"label":{"type":"string","minLength":2,"maxLength":120},"temperature_c":{"type":"number","minimum":-20,"maximum":60},"feels_like_c":{"type":"number","minimum":-30,"maximum":70},"humidity_percent":{"type":"number","minimum":0,"maximum":100},"uv_index":{"type":"number","minimum":0,"maximum":20},"wind_kph":{"type":"number","minimum":0,"maximum":200},"overnight_low_c":{"type":"number","minimum":-30,"maximum":50},"peak_window":{"type":"string","minLength":3,"maxLength":40}}},"exposure":{"type":"object","additionalProperties":false,"properties":{"exertion":{"type":"string","enum":["low","moderate","high"]},"shade":{"type":"string","enum":["none","partial","full"]},"duration_minutes":{"type":"integer","minimum":10,"maximum":720},"vulnerable_person":{"type":"boolean"},"start_local":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"oneOf":[{"required":["city_slug"],"not":{"required":["conditions"]}},{"required":["conditions"],"not":{"required":["city_slug"]}}]},"examples":{"city":{"value":{"tier":"standard","city_slug":"phoenix","exposure":{"exertion":"moderate","shade":"partial","duration_minutes":90}}},"conditions":{"value":{"tier":"standard","conditions":{"label":"Madrid outdoor work","temperature_c":38,"feels_like_c":41,"humidity_percent":31,"uv_index":10,"wind_kph":9,"overnight_low_c":25,"peak_window":"13:00-20:00"},"exposure":{"exertion":"high","shade":"none","duration_minutes":120}}}}}}},"x-pricing":{"tier":"standard","price_usd":1},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.000000"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}],"offers":[{"amount":"1000000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"El Nino Wiki standard heat-risk briefing","intent":"charge","method":"tempo"}]},"x-payment-network":{"name":"Tempo","chainId":4217,"origin":"https://mpp.elnino.wiki"},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["result","payment","idempotent_replay"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["request_id","tier","location","risk_score","status","peak_window","summary","factors","recommendations","provenance","disclaimer"],"properties":{"request_id":{"type":"string"},"tier":{"type":"string","enum":["preview","standard","premium"]},"location":{"type":"string"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"status":{"type":"string","enum":["Safe","Warm","Caution","Danger","El Nino Mode"]},"peak_window":{"type":"string"},"summary":{"type":"string"},"factors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","impact","evidence"],"properties":{"name":{"type":"string"},"impact":{"type":"string","enum":["lowers-risk","neutral","raises-risk","major-driver"]},"evidence":{"type":"string"}}}},"recommendations":{"type":"array","minItems":1,"items":{"type":"string"}},"schedule":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["window","guidance"],"properties":{"window":{"type":"string"},"guidance":{"type":"string"}}}},"provenance":{"type":"object","additionalProperties":false,"required":["source_type","freshness"],"properties":{"source_type":{"type":"string","enum":["published-city-baseline","caller-supplied-conditions"]},"freshness":{"type":"string"}}},"disclaimer":{"type":"string"}}},"payment":{"type":"object","additionalProperties":false,"required":["protocol","reference","receipt_header","amount_usd","currency","receiver"],"properties":{"protocol":{"type":"string","enum":["x402","mpp"]},"reference":{"type":"string"},"receipt_header":{"type":"string","enum":["PAYMENT-RESPONSE","Payment-Receipt"]},"amount_usd":{"type":"number"},"currency":{"type":"string"},"receiver":{"type":"string"}}},"idempotent_replay":{"type":"boolean"}}}}},"headers":{"Payment-Receipt":{"description":"MPP payment receipt","schema":{"type":"string"}}}},"400":{"description":"Invalid input or idempotency key","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}},"402":{"description":"MPP Payment Required","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}},"headers":{"WWW-Authenticate":{"description":"MPP Payment challenge","schema":{"type":"string"}}}},"503":{"description":"Operator payment configuration is not ready","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}}}}},"/api/mpp/v1/premium":{"post":{"operationId":"mppPremiumHeatRisk","summary":"Premium heat-risk briefing via MPP","tags":["MPP"],"security":[{"MPPPayment":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"8 to 128 URL-safe characters. Reuse only when retrying the same paid operation.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._~-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tier"],"properties":{"tier":{"type":"string","enum":["preview","standard","premium"],"description":"Depth of the requested briefing."},"city_slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9-]+$","description":"Supported city slug such as paris, phoenix, or new-york."},"conditions":{"type":"object","additionalProperties":false,"required":["label","temperature_c","feels_like_c","humidity_percent","uv_index","wind_kph","overnight_low_c"],"properties":{"label":{"type":"string","minLength":2,"maxLength":120},"temperature_c":{"type":"number","minimum":-20,"maximum":60},"feels_like_c":{"type":"number","minimum":-30,"maximum":70},"humidity_percent":{"type":"number","minimum":0,"maximum":100},"uv_index":{"type":"number","minimum":0,"maximum":20},"wind_kph":{"type":"number","minimum":0,"maximum":200},"overnight_low_c":{"type":"number","minimum":-30,"maximum":50},"peak_window":{"type":"string","minLength":3,"maxLength":40}}},"exposure":{"type":"object","additionalProperties":false,"properties":{"exertion":{"type":"string","enum":["low","moderate","high"]},"shade":{"type":"string","enum":["none","partial","full"]},"duration_minutes":{"type":"integer","minimum":10,"maximum":720},"vulnerable_person":{"type":"boolean"},"start_local":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"oneOf":[{"required":["city_slug"],"not":{"required":["conditions"]}},{"required":["conditions"],"not":{"required":["city_slug"]}}]},"examples":{"city":{"value":{"tier":"standard","city_slug":"phoenix","exposure":{"exertion":"moderate","shade":"partial","duration_minutes":90}}},"conditions":{"value":{"tier":"standard","conditions":{"label":"Madrid outdoor work","temperature_c":38,"feels_like_c":41,"humidity_percent":31,"uv_index":10,"wind_kph":9,"overnight_low_c":25,"peak_window":"13:00-20:00"},"exposure":{"exertion":"high","shade":"none","duration_minutes":120}}}}}}},"x-pricing":{"tier":"premium","price_usd":3},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"3.000000"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}],"offers":[{"amount":"3000000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"El Nino Wiki premium heat-risk briefing","intent":"charge","method":"tempo"}]},"x-payment-network":{"name":"Tempo","chainId":4217,"origin":"https://mpp.elnino.wiki"},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["result","payment","idempotent_replay"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["request_id","tier","location","risk_score","status","peak_window","summary","factors","recommendations","provenance","disclaimer"],"properties":{"request_id":{"type":"string"},"tier":{"type":"string","enum":["preview","standard","premium"]},"location":{"type":"string"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"status":{"type":"string","enum":["Safe","Warm","Caution","Danger","El Nino Mode"]},"peak_window":{"type":"string"},"summary":{"type":"string"},"factors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","impact","evidence"],"properties":{"name":{"type":"string"},"impact":{"type":"string","enum":["lowers-risk","neutral","raises-risk","major-driver"]},"evidence":{"type":"string"}}}},"recommendations":{"type":"array","minItems":1,"items":{"type":"string"}},"schedule":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["window","guidance"],"properties":{"window":{"type":"string"},"guidance":{"type":"string"}}}},"provenance":{"type":"object","additionalProperties":false,"required":["source_type","freshness"],"properties":{"source_type":{"type":"string","enum":["published-city-baseline","caller-supplied-conditions"]},"freshness":{"type":"string"}}},"disclaimer":{"type":"string"}}},"payment":{"type":"object","additionalProperties":false,"required":["protocol","reference","receipt_header","amount_usd","currency","receiver"],"properties":{"protocol":{"type":"string","enum":["x402","mpp"]},"reference":{"type":"string"},"receipt_header":{"type":"string","enum":["PAYMENT-RESPONSE","Payment-Receipt"]},"amount_usd":{"type":"number"},"currency":{"type":"string"},"receiver":{"type":"string"}}},"idempotent_replay":{"type":"boolean"}}}}},"headers":{"Payment-Receipt":{"description":"MPP payment receipt","schema":{"type":"string"}}}},"400":{"description":"Invalid input or idempotency key","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}},"402":{"description":"MPP Payment Required","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}},"headers":{"WWW-Authenticate":{"description":"MPP Payment challenge","schema":{"type":"string"}}}},"503":{"description":"Operator payment configuration is not ready","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}}}}}}},"/mcp":{"post":{"operationId":"mcpStreamableHttp","summary":"MCP Streamable HTTP JSON-RPC endpoint","description":"Exposes service_info, service_preview, and service_execute. Paid MCP tools use the native MPP MCP transport with JSON-RPC error -32042, Credential metadata, and Receipt metadata.","tags":["MCP"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"MCP JSON-RPC request"},"examples":{"city":{"value":{"tier":"standard","city_slug":"phoenix","exposure":{"exertion":"moderate","shade":"partial","duration_minutes":90}}},"conditions":{"value":{"tier":"standard","conditions":{"label":"Madrid outdoor work","temperature_c":38,"feels_like_c":41,"humidity_percent":31,"uv_index":10,"wind_kph":9,"overnight_low_c":25,"peak_window":"13:00-20:00"},"exposure":{"exertion":"high","shade":"none","duration_minutes":120}}}}}}},"responses":{"200":{"description":"MCP JSON-RPC response","content":{"application/json":{"schema":{"type":"object"}}}}}},"get":{"operationId":"mcpStream","summary":"MCP Streamable HTTP stream","tags":["MCP"],"security":[],"responses":{"200":{"description":"MCP stream or protocol response"}}},"delete":{"operationId":"mcpClose","summary":"Close an MCP session when a session transport is in use","tags":["MCP"],"security":[],"responses":{"200":{"description":"MCP protocol response"}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","summary":"OpenAPI 3.1 discovery document","tags":["Discovery"],"security":[],"responses":{"200":{"description":"This document","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"Compact agent instructions","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Plain-text agent integration summary","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/.well-known/agent.json":{"get":{"operationId":"getAgentCard","summary":"Domain and payment identity metadata","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Agent card","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/agent-registration.json":{"get":{"operationId":"getErc8004Registration","summary":"ERC-8004 agent registration metadata","description":"Domain-hosted ERC-8004 registration-v1 metadata. The registrations array remains empty until an on-chain identity registration is confirmed.","tags":["Discovery"],"security":[],"responses":{"200":{"description":"ERC-8004 agent registration file","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"ServiceInput":{"type":"object","additionalProperties":false,"required":["tier"],"properties":{"tier":{"type":"string","enum":["preview","standard","premium"],"description":"Depth of the requested briefing."},"city_slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9-]+$","description":"Supported city slug such as paris, phoenix, or new-york."},"conditions":{"type":"object","additionalProperties":false,"required":["label","temperature_c","feels_like_c","humidity_percent","uv_index","wind_kph","overnight_low_c"],"properties":{"label":{"type":"string","minLength":2,"maxLength":120},"temperature_c":{"type":"number","minimum":-20,"maximum":60},"feels_like_c":{"type":"number","minimum":-30,"maximum":70},"humidity_percent":{"type":"number","minimum":0,"maximum":100},"uv_index":{"type":"number","minimum":0,"maximum":20},"wind_kph":{"type":"number","minimum":0,"maximum":200},"overnight_low_c":{"type":"number","minimum":-30,"maximum":50},"peak_window":{"type":"string","minLength":3,"maxLength":40}}},"exposure":{"type":"object","additionalProperties":false,"properties":{"exertion":{"type":"string","enum":["low","moderate","high"]},"shade":{"type":"string","enum":["none","partial","full"]},"duration_minutes":{"type":"integer","minimum":10,"maximum":720},"vulnerable_person":{"type":"boolean"},"start_local":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"oneOf":[{"required":["city_slug"],"not":{"required":["conditions"]}},{"required":["conditions"],"not":{"required":["city_slug"]}}]},"ServiceOutput":{"type":"object","additionalProperties":false,"required":["request_id","tier","location","risk_score","status","peak_window","summary","factors","recommendations","provenance","disclaimer"],"properties":{"request_id":{"type":"string"},"tier":{"type":"string","enum":["preview","standard","premium"]},"location":{"type":"string"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"status":{"type":"string","enum":["Safe","Warm","Caution","Danger","El Nino Mode"]},"peak_window":{"type":"string"},"summary":{"type":"string"},"factors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","impact","evidence"],"properties":{"name":{"type":"string"},"impact":{"type":"string","enum":["lowers-risk","neutral","raises-risk","major-driver"]},"evidence":{"type":"string"}}}},"recommendations":{"type":"array","minItems":1,"items":{"type":"string"}},"schedule":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["window","guidance"],"properties":{"window":{"type":"string"},"guidance":{"type":"string"}}}},"provenance":{"type":"object","additionalProperties":false,"required":["source_type","freshness"],"properties":{"source_type":{"type":"string","enum":["published-city-baseline","caller-supplied-conditions"]},"freshness":{"type":"string"}}},"disclaimer":{"type":"string"}}},"PaidServiceResponse":{"type":"object","additionalProperties":false,"required":["result","payment","idempotent_replay"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["request_id","tier","location","risk_score","status","peak_window","summary","factors","recommendations","provenance","disclaimer"],"properties":{"request_id":{"type":"string"},"tier":{"type":"string","enum":["preview","standard","premium"]},"location":{"type":"string"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"status":{"type":"string","enum":["Safe","Warm","Caution","Danger","El Nino Mode"]},"peak_window":{"type":"string"},"summary":{"type":"string"},"factors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","impact","evidence"],"properties":{"name":{"type":"string"},"impact":{"type":"string","enum":["lowers-risk","neutral","raises-risk","major-driver"]},"evidence":{"type":"string"}}}},"recommendations":{"type":"array","minItems":1,"items":{"type":"string"}},"schedule":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["window","guidance"],"properties":{"window":{"type":"string"},"guidance":{"type":"string"}}}},"provenance":{"type":"object","additionalProperties":false,"required":["source_type","freshness"],"properties":{"source_type":{"type":"string","enum":["published-city-baseline","caller-supplied-conditions"]},"freshness":{"type":"string"}}},"disclaimer":{"type":"string"}}},"payment":{"type":"object","additionalProperties":false,"required":["protocol","reference","receipt_header","amount_usd","currency","receiver"],"properties":{"protocol":{"type":"string","enum":["x402","mpp"]},"reference":{"type":"string"},"receipt_header":{"type":"string","enum":["PAYMENT-RESPONSE","Payment-Receipt"]},"amount_usd":{"type":"number"},"currency":{"type":"string"},"receiver":{"type":"string"}}},"idempotent_replay":{"type":"boolean"}}},"Error":{"type":"object","additionalProperties":false,"required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"request_id":{"type":"string"}}}},"securitySchemes":{"X402Payment":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 payment credential returned after satisfying PAYMENT-REQUIRED."},"MPPPayment":{"type":"http","scheme":"Payment","description":"MPP Payment credential created from the WWW-Authenticate challenge."}}},"tags":[{"name":"Free","description":"No payment required"},{"name":"Limited","description":"Anonymous and rate limited"},{"name":"Payment","description":"Payment selection and protected execution"},{"name":"x402","description":"x402 v2 exact payments"},{"name":"MPP","description":"Machine Payments Protocol one-time charge"},{"name":"MCP","description":"Model Context Protocol tools"},{"name":"Discovery","description":"Machine-readable service metadata"}]}