Quickstart

Option A: Let your agent onboard you

Install the onboarding MCP in your agent and hand it one prompt — it walks you through sign-up, creates an API key, and configures the weather MCP for you. See Built for Agents for the full flow.

Set me up with a Smarter Weather API key and configure the weather MCP.

Option B: Manual setup

1. Create an API Key

Create a free account, then mint an API key from your Developer Dashboard. Your key will look like sw_live_xxxxxxxxxxxxxxxx.

2. Make Your First Request

The unified /v1/weather endpoint returns everything you need in a single call. Pass your coordinates and your API key as an HTTP Bearer token:

curl "https://api.smarterweather.com/v1/weather?lat=40.7128&lon=-74.0060&units=imperial" \
  -H "Authorization: Bearer YOUR_API_KEY"

Success is HTTP 200 with location.name set (for this example, a New York place label) and a populated current object. Anything else is a failure — parse the RFC 7807 application/problem+json body.

3. Understand the Response

The response is a single JSON object containing all weather data for the requested location:

{
  "location": {
    "lat": 40.7128,
    "lon": -74.006,
    "name": "New York",
    "region": "NY",
    "timezone": "America/New_York"
  },
  "current": {
    "temperature": 72,
    "feels_like": 74,
    "humidity": 55,
    "wind_speed": 8,
    "wind_direction": "SW",
    "conditions": "Partly Cloudy",
    "icon": "partly_cloudy_day"
  },
  "hourly": [ ... ],
  "daily": [ ... ],
  "alerts": [ ... ],
  "radar": { ... }
}

4. Filter Response Sections

Use the include parameter to request only the sections you need, reducing payload size:

curl "https://api.smarterweather.com/v1/weather?lat=40.7128&lon=-74.0060&include=current,alerts" \
  -H "Authorization: Bearer YOUR_API_KEY"

5. Try the MCP Server

If you're building AI applications, check out our MCP Server for direct AI assistant integration with 31 specialized weather tools.