{
  "markdown": "# 🌦 WeatherTrax MCP Server\n\nRun instantly:\n\n```bash\nnpx @jaredco/weather-mcp-server\n```\n\nFast, reliable weather data for **Claude and other MCP clients**.  \nGet current conditions and multi-day forecasts for any location worldwide.\n\n🌐 **Remote MCP Server (no install required)**  \nhttps://mcp-weathertrax.jaredco.com\n\n---\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![MCP Protocol](https://img.shields.io/badge/MCP-2025--03--26-blue)](https://modelcontextprotocol.io/)\n[![Tests Passing](https://img.shields.io/badge/tests-67%2F67%20passing-brightgreen)]()\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-Registered-blue)](https://registry.modelcontextprotocol.io/v0.1/servers?search=jaredco)\n\n---\n\n# ⚡ 10-Second Demo\n\nAsk Claude:\n\n> **“What’s the weather in Miami tomorrow?”**\n\nClaude will call the MCP weather server and return a forecast instantly.\n\nExample API call:\n\n```bash\ncurl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"location\":\"Miami\",\"query_type\":\"current\"}'\n```\n\n---\n\n# 🚀 Features\n\n- **Real-time Weather Data** – Current conditions, temperature, humidity, wind speed\n- **Multi-day Forecasts** – Up to 14-day forecasts\n- **Planning Tool** – 7-day forecasts optimized for events or construction\n- **Flexible Locations** – City names, ZIP codes, or coordinates\n- **Token-Efficient** – Compact responses optimized for LLM usage\n- **Production-Ready** – Rate limiting and monitoring\n- **Public API** – No API keys required\n- **MCP Compliant** – Full JSON-RPC 2.0 support\n\n---\n\n# ⚡ Quick Start\n\n## Claude Desktop\n\nAdd this to your Claude Desktop configuration:\n\n```\n~/Library/Application Support/Claude/claude_desktop_config.json\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"weathertrax\": {\n      \"url\": \"https://mcp-weathertrax.jaredco.com\"\n    }\n  }\n}\n```\n\nRestart Claude Desktop.\n\nYou can now ask:\n\n```\nWhat’s the weather in New York this weekend?\n```\n\n---\n\n# 🌐 Direct API Usage\n\n### Health Check\n\n```bash\ncurl https://mcp-weathertrax.jaredco.com/healthz\n```\n\n### MCP Manifest\n\n```bash\ncurl https://mcp-weathertrax.jaredco.com/.well-known/mcp/manifest\n```\n\n---\n\n# 💡 Usage Examples\n\n## Current Weather\n\n```bash\ncurl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"location\": \"San Francisco, CA\",\n    \"query_type\": \"current\"\n  }'\n```\n\nExample response:\n\n```json\n{\n  \"summary\": \"It is currently 54°F and Clear in San Francisco.\",\n  \"temp_high\": 54,\n  \"temp_low\": 54,\n  \"condition\": \"Clear\",\n  \"wind\": \"5 mph W\",\n  \"humidity\": 65\n}\n```\n\n---\n\n## Multi-Day Forecast\n\n```bash\ncurl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"location\": \"New York\",\n    \"query_type\": \"multi_day\",\n    \"num_days\": 3\n  }'\n```\n\n---\n\n# 🛠 Available Tools\n\n### weatherTool\n\nRetrieve current weather or forecasts.\n\nInput:\n\n```json\n{\n  \"location\": \"city name or coordinates\",\n  \"query_type\": \"current | multi_day\",\n  \"num_days\": \"optional forecast length\"\n}\n```\n\n---\n\n### weatherPlanningTool\n\n7-day planning forecast for outdoor work or events.\n\nInput:\n\n```json\n{\n  \"location\": \"city or place\",\n  \"context\": \"construction | travel | event\",\n  \"timeframe\": \"optional timeframe hint\"\n}\n```\n\n---\n\n# 🔗 MCP Protocol Integration\n\nThis server supports the full MCP JSON-RPC protocol.\n\nExample tool call:\n\n```bash\ncurl -X POST https://mcp-weathertrax.jaredco.com/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\":\"2.0\",\n    \"id\":1,\n    \"method\":\"tools/call\",\n    \"params\":{\n      \"name\":\"weatherTool\",\n      \"arguments\":{\n        \"location\":\"London\",\n        \"query_type\":\"current\"\n      }\n    }\n  }'\n```\n\n---\n\n# 🧪 Testing\n\nRun locally:\n\n```bash\nnpm install\nnpm start\n```\n\nQuick tests:\n\n```bash\nnpm test\n```\n\nFull test suite:\n\n```bash\nnpm run test:full\n```\n\nCurrent results:\n\n```\n67 / 67 tests passing\n```\n\n---\n\n# 🔒 Privacy\n\nPrivacy policy available at:\n\nhttps://mcp-weathertrax.jaredco.com/privacy\n\nKey points:\n\n- Request metadata logged for abuse prevention\n- No persistent storage of weather queries\n- No cookies or tracking\n- HTTPS enforced\n\n---\n\n# 🛠 Development\n\nClone the repo:\n\n```bash\ngit clone https://github.com/jaredco/weather-mcp-server.git\ncd weather-mcp-server\nnpm install\nnpm start\n```\n\nServer runs locally at:\n\n```\nhttp://localhost:3000\n```\n\n---\n\n# 📦 Technology Stack\n\n- Node.js\n- Express 5\n- @modelcontextprotocol/sdk\n- World Weather Online API\n- Railway hosting\n\n---\n\n# 📄 License\n\nMIT License.\n\n---\n\n# 🌟 Acknowledgments\n\nBuilt using the **Model Context Protocol** by Anthropic.\n\nWeather data provided by **World Weather Online**.\n\n---\n\n# 📊 Status\n\nServer: **Production**  \nAPI Version: **1.0.1**  \nMCP Protocol: **2025-03-26**\n\n---\n\nMade with ☀️ for Claude and MCP",
  "bytes": 4837,
  "sha": "2a6334c909330c3c3d614ec651c4d449d90a5c02b2f1a94e28c47c26c00fc72e",
  "repo_slug": "jaredco/weather-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jaredco_ai_weather_mcp_server_175ab5dd/readme"
}