Use with AI assistants

Vertical Weather runs an MCP server, so an AI assistant can fetch profiles for you while you chat or code. It uses the same API keys, limits and data as the HTTP API.

• Address: https://api.verticalweather.com/mcp (Streamable HTTP)
• Authentication: your API key in the X-API-Key header

Tools

Tool	What it does	Key needed
get_atmospheric_profile	Wind, temperature, pressure, humidity and density at up to 32 heights above a point	Yes
get_capabilities	Current coverage and limits	No
get_usage	Today’s remaining allowance	Yes

All three only read data. Errors come back as text the assistant can act on, including the available height range when a height is too low or too high.

Set up your client

Get a key from the dashboard first. The key is stored in your client’s config on your own machine; don’t commit that file to a repository.

Claude Code

claude mcp add --transport http vertical-weather \
  https://api.verticalweather.com/mcp \
  --header "X-API-Key: YOUR_KEY"

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "vertical-weather": {
      "url": "https://api.verticalweather.com/mcp",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}

VS Code

In .vscode/mcp.json, with the key asked for once and kept by VS Code:

{
  "inputs": [
    { "type": "promptString", "id": "vw-key", "description": "Vertical Weather API key", "password": true }
  ],
  "servers": {
    "vertical-weather": {
      "type": "http",
      "url": "https://api.verticalweather.com/mcp",
      "headers": { "X-API-Key": "${input:vw-key}" }
    }
  }
}

Codex

In ~/.codex/config.toml, with the key read from an environment variable:

[mcp_servers.vertical-weather]
url = "https://api.verticalweather.com/mcp"
env_http_headers = { "X-API-Key" = "VERTICAL_WEATHER_API_KEY" }

OpenAI API and Claude API

Agents you build yourself can use the server as a remote MCP tool. With OpenAI’s Responses API:

{
  "type": "mcp",
  "server_label": "vertical_weather",
  "server_url": "https://api.verticalweather.com/mcp",
  "headers": { "X-API-Key": "YOUR_KEY" },
  "require_approval": "never"
}

The Claude API’s MCP connector sends the key as a bearer token, which the server also accepts: set authorization_token to your key.

Claude Desktop and other clients

Clients that can’t send a custom header can connect through mcp-remote. In Claude Desktop’s claude_desktop_config.json:

{
  "mcpServers": {
    "vertical-weather": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.verticalweather.com/mcp",
               "--header", "X-API-Key:${VW_KEY}"],
      "env": { "VW_KEY": "YOUR_KEY" }
    }
  }
}

The ChatGPT app can’t connect yet: it only supports MCP servers that sign in with OAuth, and this one uses API keys.

Try it

Ask something like “What’s the wind at 1, 3 and 5 km above Mojave, California tomorrow at noon local time?” The assistant should call get_atmospheric_profile and report wind speed and the direction it’s coming from at each height.

Model forecasts aren’t a substitute for an official weather briefing. Don’t use them on their own for safety-critical decisions.