{"uid":"cap_W4l8PeY_LETj-qahEkT7F","slug":"travel-agent-weather-aware-plan-3b580e65","name":"Travel Agent Weather-Aware Plan","description":"Returns an outdoor-fit rating, weather tradeoffs, and transportation exposure notes for a destination or coordinates, with confidence caveats. Use to decide whether to shift timing or route before a trip.","url":"https://travel-agent.forgemesh.io/api/weather-aware-plan","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"date":{"type":"string"},"plan_type":{"type":"string"},"destination":{"type":"string"},"time_window":{"type":"string"},"transportation_modes":{"type":"string"},"max_distance_or_travel_time":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"category":"weather_aware_planning","conditions":{"outdoor_fit":"mixed"},"confidence":"medium","why_not_high":["Forecasts can shift near departure, especially for rain, wind, heat, and exposed transportation choices."],"planning_awareness":"..."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JXIn6eglKk69Xpy5pqfcD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns weather-aware planning context for a destination or coordinate pair, including outdoor activity fit, weather tradeoffs, transportation exposure, and suggested next actions.","exampleAgentPrompt":"Can you give me a weather-aware planning brief for a sightseeing trip to Rome on Saturday, covering outdoor activity fit, weather tradeoffs, and whether walking versus transit makes more sense given the conditions?","exampleUseCases":null,"resultDescription":"A structured planning context object containing outdoor activity fitness assessment, weather tradeoffs for the destination and date, transportation exposure analysis for requested modes, freshness metadata, and a list of suggested next actions — all tailored to the specified destination or lat/lon coordinate pair.","failureModes":["Missing required 'type' or 'method' input fields returns a 400 validation error","Invalid or unresolvable destination name with no lat/lon fallback may return empty or error data","Date too far in the future may result in low-confidence or unavailable forecast data","Invalid coordinate values (out of range lat/lon) may cause a lookup failure","Malformed transportation_modes string may result in incomplete exposure analysis","Rate limit or payment failure returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need a composite, weather-contextualized planning brief for a specific destination or coordinate pair on a given date — especially when outdoor fit, transportation exposure, and actionable next steps are all needed together. Prefer this over a raw weather API when you want pre-interpreted travel planning context rather than raw forecast data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:37:55.614Z","isFirstParty":false}