{"openapi":"3.0.3","info":{"title":"ForgeMesh Travel Intelligence","version":"0.1.0"},"servers":[{"url":"https://travel-agent.forgemesh.io"}],"x-x402":{"network":"eip155:8453","payTo":"0x7F7C9bfF1DDF2817641740962A9872e6421eBBFc","facilitator":"https://x402.xyz/facilitate","paymentSchemes":{"exact":{"status":"live","reason":"Current travel endpoints have fixed prices."},"upto":{"status":"planned_if_usage_based_pricing_is_added","reason":"Useful for future dynamic/usage-priced endpoints where the final charge is below a client-approved maximum."},"batch-settlement":{"status":"planned_if_high_volume_repeat_micropayments_arrive","reason":"Useful later for repeated micropayments, not necessary for the current low-volume fixed-price launch surface."}},"extensions":{"bazaar":{"status":"live","purpose":"Agent marketplace discovery with input examples, input schemas, output examples, and output schemas on live paid routes."},"payment-identifier":{"status":"live","required":false,"purpose":"Optional idempotency marker for clients that want retry-safe logical requests."},"offer-receipt":{"status":"live","includeTxHash":false,"offerValiditySeconds":300,"purpose":"Signed offers in 402 responses and signed receipts after successful settlement when a service signing key is configured."},"builder-code":{"status":"live","code":"bc_4ypyymtf","purpose":"ERC-8021 attribution for x402 settlement calldata after a Base builder code is minted and configured."},"sign-in-with-x":{"status":"not_needed_for_one_shot_travel_outputs"},"eip2612-gas-sponsoring":{"status":"not_exported_by_installed_extensions_package"},"erc20-approval-gas-sponsoring":{"status":"not_exported_by_installed_extensions_package"}},"forgemeshNetwork":{"publisher":{"name":"ForgeMesh Labs","url":"https://forgemesh.io","relationship":"publisher"},"currentService":{"name":"ForgeMesh Travel Intelligence","url":"https://travel-agent.forgemesh.io","relationship":"current_x402_resource_server"},"relatedServices":[{"name":"ForgeMesh x402 Services","url":"https://x402.coinopai.com","relationship":"sibling_x402_service_index","description":"Related ForgeMesh paid agent endpoints and x402 service examples."},{"name":"CoinOpAI","url":"https://coinopai.com","relationship":"agent_monetization_hub","description":"ForgeMesh agent monetization and MCP/x402 product surface."},{"name":"Kronos Market Intelligence","url":"https://x402.coinopai.com","relationship":"sibling_paid_endpoint_family","description":"Related x402 market intelligence endpoints from ForgeMesh."},{"name":"x402 Image Generation","url":"https://x402.coinopai.com","relationship":"sibling_paid_endpoint_family","description":"Related ForgeMesh x402 creative generation endpoint family."},{"name":"Travel Agent MCP","url":"https://github.com/forgemeshlabs/travel-agent-mcp","relationship":"mcp_client_package","description":"MCP package that exposes local travel tools and prepares x402 handoffs to this resource server."},{"name":"Disruption Intelligence MCP","url":"https://github.com/forgemeshlabs/disruption-intelligence-mcp","relationship":"related_mcp_product","description":"Related ForgeMesh MCP wrapper for commercial disruption signals."},{"name":"ForgeMesh ImageGen MCP","url":"https://github.com/forgemeshlabs/imagegen-mcp","relationship":"related_mcp_product","description":"Related ForgeMesh MCP wrapper for paid image generation and cleanup."}]}},"paths":{"/health":{"get":{"summary":"Health check","responses":{"200":{"description":"Service is healthy"}}}},"/api/categories":{"get":{"summary":"List travel intelligence categories","responses":{"200":{"description":"Category list"}}}},"/api/transit-providers":{"get":{"summary":"Live paid mobility options finder","x-x402-price":"$0.01","x-x402":{"price":"$0.01","network":"base","status":"live"},"parameters":[{"name":"location","in":"query","schema":{"type":"string"}},{"name":"transportation_type","in":"query","schema":{"type":"string"}},{"name":"trip_style","in":"query","schema":{"type":"string"}},{"name":"origin","in":"query","schema":{"type":"string"}},{"name":"destination","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Short mobility option matches after x402 settlement, or in PAYMENT_MODE=prototype"},"402":{"description":"Payment required when production payment middleware is wired"},"503":{"description":"Paid data path is planned when PAYMENT_MODE=planned"}}}},"/api/request-coverage":{"get":{"summary":"Free creator/local coverage request","x-x402":{"paymentRequired":false,"status":"live_free"},"parameters":[{"name":"town","in":"query","schema":{"type":"string"}},{"name":"location","in":"query","schema":{"type":"string"}},{"name":"destination","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"signal_types","in":"query","schema":{"type":"string"}},{"name":"source_links","in":"query","schema":{"type":"string"}},{"name":"creator_angle","in":"query","schema":{"type":"string"}},{"name":"contact","in":"query","schema":{"type":"string"}},{"name":"notes","in":"query","schema":{"type":"string"}},{"name":"recheck_days","in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":"Coverage request receipt"},"400":{"description":"Missing town/location/destination"}}}},"/api/day-trip-plan":{"get":{"summary":"Live paid day-trip plan with optional transit-aware strategy","x-x402-price":"$0.10","x-x402":{"price":"$0.10","network":"base","status":"live"},"parameters":[{"name":"origin","in":"query","schema":{"type":"string"}},{"name":"destination","in":"query","schema":{"type":"string"}},{"name":"radius_miles","in":"query","schema":{"type":"number"}},{"name":"max_distance_or_travel_time","in":"query","schema":{"type":"string"}},{"name":"date","in":"query","schema":{"type":"string"}},{"name":"interests","in":"query","schema":{"type":"string"}},{"name":"budget","in":"query","schema":{"type":"string"}},{"name":"include_local_context","in":"query","schema":{"type":"boolean"}},{"name":"origin_station","in":"query","schema":{"type":"string"}},{"name":"arrival_station","in":"query","schema":{"type":"string"}},{"name":"max_transfers","in":"query","schema":{"type":"string"}},{"name":"walking_tolerance","in":"query","schema":{"type":"string"}},{"name":"return_by","in":"query","schema":{"type":"string"}},{"name":"avoid_driving","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Day-trip planning output after x402 settlement, or in PAYMENT_MODE=prototype"},"402":{"description":"Payment required when production payment middleware is wired"},"503":{"description":"Paid data path is planned when PAYMENT_MODE=planned"}}}},"/api/weather-aware-plan":{"get":{"summary":"Live paid weather-aware planning","x-x402-price":"$0.03","x-x402":{"price":"$0.03","network":"base","status":"live"},"parameters":[{"name":"destination","in":"query","schema":{"type":"string"}},{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lon","in":"query","schema":{"type":"number"}},{"name":"date","in":"query","schema":{"type":"string"}},{"name":"plan_type","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Weather-aware planning output after x402 settlement, or in PAYMENT_MODE=prototype"},"402":{"description":"Payment required when production payment middleware is wired"},"503":{"description":"Paid data path is planned when PAYMENT_MODE=planned"}}}},"/api/weekend-getaway":{"get":{"summary":"Live paid weekend getaway planning","x-x402-price":"$0.25","x-x402":{"price":"$0.25","network":"base","status":"live"},"parameters":[{"name":"origin","in":"query","schema":{"type":"string"}},{"name":"destination","in":"query","schema":{"type":"string"}},{"name":"start_date","in":"query","schema":{"type":"string"}},{"name":"end_date","in":"query","schema":{"type":"string"}},{"name":"transportation_modes","in":"query","schema":{"type":"string"}},{"name":"max_distance_or_travel_time","in":"query","schema":{"type":"string"}},{"name":"budget","in":"query","schema":{"type":"string"}},{"name":"lodging_style","in":"query","schema":{"type":"string"}},{"name":"trip_style","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Weekend getaway planning output after x402 settlement, or in PAYMENT_MODE=prototype"},"402":{"description":"Payment required when production payment middleware is wired"},"503":{"description":"Paid data path is planned when PAYMENT_MODE=planned"}}}},"/api/event-trip-plan":{"get":{"summary":"Planned paid special event trip planning","x-x402-price":"$0.25","x-x402":{"price":"$0.25","network":"base","status":"planned"},"parameters":[{"name":"event_name","in":"query","schema":{"type":"string"}},{"name":"event_location","in":"query","schema":{"type":"string"}},{"name":"event_dates","in":"query","schema":{"type":"string"}},{"name":"origin","in":"query","schema":{"type":"string"}},{"name":"transportation_modes","in":"query","schema":{"type":"string"}},{"name":"budget","in":"query","schema":{"type":"string"}},{"name":"event_style","in":"query","schema":{"type":"string"}},{"name":"must_be_there_times","in":"query","schema":{"type":"string"}}],"responses":{"503":{"description":"Paid data path is not live yet"}}}},"/api/creator-experiences":{"get":{"summary":"Live paid creator experience planning","x-x402-price":"$0.25","x-x402":{"price":"$0.25","network":"base","status":"live"},"parameters":[{"name":"destination","in":"query","schema":{"type":"string"},"required":true},{"name":"trip_length","in":"query","schema":{"type":"string"}},{"name":"content_style","in":"query","schema":{"type":"string"}},{"name":"emerging_local_signals","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Creator experience planning output after x402 settlement, or in PAYMENT_MODE=prototype"},"402":{"description":"Payment required when production payment middleware is wired"},"503":{"description":"Paid data path is planned when PAYMENT_MODE=planned"}}}},"/api/emerging-local-signals":{"get":{"summary":"Planned paid creator-ready emerging local signals","x-x402-price":"$0.05","x-x402":{"price":"$0.05","network":"base","status":"planned"},"parameters":[{"name":"location","in":"query","schema":{"type":"string"}},{"name":"destination","in":"query","schema":{"type":"string"}},{"name":"signal_types","in":"query","schema":{"type":"string"}},{"name":"lookback_days","in":"query","schema":{"type":"number"}},{"name":"business_type","in":"query","schema":{"type":"string"}},{"name":"neighborhood","in":"query","schema":{"type":"string"}},{"name":"content_style","in":"query","schema":{"type":"string"}}],"responses":{"402":{"description":"Payment required when live"},"503":{"description":"Paid data path is planned"}}}},"/api/trip-price-guidance":{"get":{"summary":"Planned paid trip price guidance","x-x402-price":"$0.10","x-x402":{"price":"$0.10","network":"base","status":"planned"},"responses":{"503":{"description":"Paid data path is not live yet"}}}},"/api/currency-exchange":{"get":{"summary":"Free currency reference-rate utility","x-x402":{"paymentRequired":false,"status":"live_free"},"parameters":[{"name":"home_currency","in":"query","schema":{"type":"string"}},{"name":"destination_currency","in":"query","schema":{"type":"string"}},{"name":"amount","in":"query","schema":{"type":"number"}},{"name":"destination","in":"query","schema":{"type":"string"}},{"name":"trip_dates","in":"query","schema":{"type":"string"}},{"name":"budget","in":"query","schema":{"type":"string"}},{"name":"spending_categories","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Simple reference-rate conversion"},"400":{"description":"Invalid currency code"},"502":{"description":"Reference-rate lookup failed"}}}},"/api/travel-pulse":{"get":{"summary":"Live paid travel pulse","x-x402-price":"$0.01","x-x402":{"price":"$0.01","network":"base","status":"live"},"parameters":[{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lon","in":"query","schema":{"type":"number"}},{"name":"radius_miles","in":"query","schema":{"type":"number"}},{"name":"lookback_hours","in":"query","schema":{"type":"number"}},{"name":"trip_phase","in":"query","schema":{"type":"string"}},{"name":"signal_types","in":"query","schema":{"type":"string"}},{"name":"water_site","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Travel pulse output after x402 settlement, or in PAYMENT_MODE=prototype"},"402":{"description":"Payment required when production payment middleware is wired"},"503":{"description":"Paid data path is planned when PAYMENT_MODE=planned"}}}}}}