WxTech Data API for AI Agents (Remote MCP Server) BETA

WxTech Data API for AI Agents is an Remote MCP (Model Context Protocol) server that provides weather data that can be used by AI agents. It provides 1km mesh weather forecasts and perceived weather forecasts for Japan, as well as 5km mesh global weather forecasts.

INFO

WxTech Data API for AI Agents is currently in beta. This service is subject to change or termination without notice.

Tools and resources

1km Mesh Pinpoint Weather & Feel-Like Forecast

Provide weather forecast and weather forecast data calculated for each 1 km grid within Japan. Weather forecasts include short-term and medium-term forecasts. Short-term forecasts are hourly weather forecasts for approximately three days, while medium-term forecasts include daily weather forecasts for 10 days.

5km Mesh Global Weather Forecast

Provide global weather forecast data calculated in 5 km grids. Weather forecasts include short-term and medium-term forecasts. Short-term forecasts are hourly weather forecasts for approximately three days, while medium-term forecasts include daily weather forecasts for 14 days.

Weather Codes

We provide weather expressions for weather codes included in weather forecast data.

How to use

Requirements

• API key for WxTech Data API for AI Agents. You can apply for a free 60-day API key using the trial application form.
• Node.js >= v18.0.0

Installation

The following shows a typical MCP Client configuration example. Replace [X_API_KEY] with the API key for WxTech Data API for AI Agents.

{
  "mcpServers": {
    "WxTech1kmMeshPinpointWeatherForecast": {
      "command": "npx",
      "args": [
          "mcp-remote",
          "https://wxtech.weathernews.com/api/beta/ss1wx/mcp/",
          "--header",
          "X-API-Key: [X_API_KEY]"
      ]
    },
    "WxTech5kmMeshGlobalWeatherForecast": {
      "command": "npx",
      "args": [
          "mcp-remote",
          "https://wxtech.weathernews.com/api/beta/global/wx/mcp/",
          "--header",
          "X-API-Key: [X_API_KEY]"
      ]
    }
  }
}

Claude Desktop

Add the above settings to claude_desktop_config.json. For details, please refer to the Claude Desktop documentation.

VS Code

Add the above settings to settings.json or .vscode/mcp.json. For details, please refer to the VSCode documentation.

Troubleshooting

When managing multiple Node.js versions with nvm, etc., the correct Node.js version may not be used when starting the Remote MCP Server from the npx command. In this case, you can resolve the issue by specifying NODE_PATH with env and specifying the full path for npx.

{
  "mcpServers": {
    "WxTech1kmMeshPinpointWeatherForecast": {
      "command": "/Users/your-username/.nvm/versions/node/v19.9.0/bin/npx",
      "args": [
          "mcp-remote",
          "https://wxtech.weathernews.com/api/beta/ss1wx/mcp/",
          "--header",
          "X-API-Key: WXTECH_X_API_KEY"
      ],
      "env": {
        "NODE_PATH": "/Users/your-username/.nvm/versions/node/v19.9.0/lib/node_modules"
      }
    }
  }
}