Setup Guide

One-click install

The fastest path — installs the stdio bridge into your client. Have your agent create the API key for you via the onboarding MCP if you don't have one yet.

Prerequisites

• A free SmarterWeather account (create one, or let your agent do it via the onboarding MCP)
• An API key from your Developer Dashboard or from create_api_key
• Node.js 18+ installed (the stdio bridge is npx)

Claude Desktop

Add the following to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS). Stdio hosts do not inherit your shell — put the key in the env slot, not in a committed file:

{
  "mcpServers": {
    "smarterweather": {
      "command": "npx",
      "args": ["-y", "@smarterweather/mcp-weather"],
      "env": {
        "SMARTERWEATHER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Prefer the one-click button above. For a manual merge into ~/.cursor/mcp.json (or the project .cursor/mcp.json):

{
  "mcpServers": {
    "smarterweather": {
      "command": "npx",
      "args": ["-y", "@smarterweather/mcp-weather"],
      "env": {
        "SMARTERWEATHER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor's native Streamable HTTP OAuth against Clerk can fail when the redirect uses the cursor:// scheme. The stdio bridge is the supported Cursor path.

Generic MCP Client

Any stdio-capable client can run the same bridge. Set SMARTERWEATHER_API_KEY in the process environment (or the host secret store that fills that slot):

npx -y @smarterweather/mcp-weather

Do not append @preview — latest is the GA bridge. The hosted weather tools live at https://mcp.smarterweather.com; the npm package is a thin stdio-to-Streamable-HTTP proxy.

Verify the Connection

After configuration, try a simple prompt in your AI client:

What's the weather in Denver, CO right now?

The AI should invoke search_locations (or accept location on the tool) and get_forecast to answer with real-time weather data.