weather
Retrieve current weather conditions and forecasts for any location using city names or coordinates to support planning and decision-making.
Instructions
Get current weather and forecast for a location ($0.001)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| location | Yes | City name or coordinates |
Implementation Reference
- index.js:39-39 (registration)The "weather" tool is registered in the TOOLS array with its schema and endpoint.
{ name: 'weather', description: 'Get current weather and forecast for a location', inputSchema: { type: 'object', properties: { location: { type: 'string', description: 'City name or coordinates' } }, required: ['location'] }, endpoint: '/weather', price: '$0.001' }, - index.js:94-115 (handler)The handler for all tools (including "weather") processes the request by calling the generic `callTool` function.
server.setRequestHandler(CallToolRequestSchema, async (request) => { const { name, arguments: args } = request.params; if (!API_KEY) { return { content: [{ type: 'text', text: 'Error: ITERATOOLS_API_KEY environment variable not set. Get a key at https://iteratools.com' }], isError: true, }; } const tool = TOOLS.find(t => t.name === name); if (!tool) { return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true }; } try { const result = await callTool(tool.endpoint, args); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }; } catch (err) { return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true }; } }); - index.js:50-79 (helper)Generic helper function that executes the API call to the specified endpoint.
async function callTool(endpoint, params) { const fetch = (await import('node-fetch')).default; const isGet = ['GET'].includes((TOOLS.find(t => t.endpoint === endpoint) || {}).method); const url = isGet ? `${BASE_URL}${endpoint}?${new URLSearchParams(params)}` : `${BASE_URL}${endpoint}`; const res = await fetch(url, { method: isGet ? 'GET' : 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${API_KEY}`, }, body: isGet ? undefined : JSON.stringify(params), }); const text = await res.text(); let data; try { data = JSON.parse(text); } catch { data = { raw: text }; } if (!res.ok) { if (res.status === 402) { throw new Error(`Insufficient credits. Add credits at https://iteratools.com. Cost: ${TOOLS.find(t=>t.endpoint===endpoint)?.price || 'see docs'}`); } throw new Error(`API error ${res.status}: ${text.substring(0, 200)}`); } return data; }