Built for agents

The onboarding flow, end to end

Anonymous discovery → OAuth (your agent's host prompts you once) → key creation → self-configuration. The tools below cover the whole account lifecycle:

Machine-readable everything

Every claim on this page is backed by a live artifact your agent can fetch and verify in under a minute:

Agent Skills

Installable procedural knowledge in the open SKILL.md standard (Claude Code, Cursor, Codex CLI, Gemini CLI, Copilot, and more). Point your agent at a skill URL or drop it into your skills directory:

Discovery index: /.well-known/skills/index.json — also listed in llms.txt.

MCP Apps widgets

Onboarding tools return interactive widgets that render inside MCP-Apps-capable hosts — sign-up, usage, configuration, and upgrades without leaving the conversation:

Agentic payments (x402)

Agents with wallets can pay per call — no account, no API key. The weather MCP advertises in-band x402 payment requirements (USDC on Base); discovery tools like search_locations, reverse_geocode, list_datasets, and describe_dataset stay free, and paid tools start at $0.01 per call.

1. Agent calls a paid tool keylessly and receives payment requirements in-band.
2. Agent signs a USDC payment authorization with its wallet.
3. Retry with proof — the tool executes and the settlement receipt returns in metadata.

Prefer a metered plan? Keys via the onboarding MCP above work on the same endpoint — see pricing.

Key handling

Every recommended mint path (login, trial, stdio start_trial, and — via the stdio bridge — create_api_key / rotate_api_key) already writes SMARTERWEATHER_API_KEY to .env (mode 0600) and returns only a prefix. If you used a raw HTTP mint, do the same by hand. These rules are what next_steps.key_handling on every 401 points at.

1. Keep the key only in .env as SMARTERWEATHER_API_KEY=… (gitignored). Never paste it into chat.
2. Read it from the environment in code (process.env, os.environ); never inline the literal. For Cursor MCP, prefer envFile pointing at the project .env.
3. Never echo the key into chat, logs, or a commit message.
4. Use sw_test_* keys in CI and for load tests; rotate from the dashboard if a key ever lands in a repository.

Human present: login

Run npx -y @smarterweather/mcp-onboarding@latest login. It prints an approval link carrying a short code; the human opens the link, signs in, checks the code matches, and approves. The CLI then writes a full key to .env (mode 0600, gitignored) and prints only a prefix.

1. A 401 leads with recommended: device_flow and carries the command in next_steps.device_flow.command.
2. login blocks until the human approves (codes last 10 minutes). Run it in the background or with a long shell timeout, and relay the printed link to the human.
3. Driving the RFC 8628 device grant yourself? See the device flow quickstart.

No human present: trial

Run npx -y @smarterweather/mcp-onboarding@latest trial (or stdio start_trial). It mints a short-lived sw_live_* trial key into .env, prints only a prefix and claim link, then a human can claim the same bearer onto the free tier.

1. A 401 with if_no_human_present: trial advertises next_steps.trial.command when trial keys are on.
2. Raw HTTP mint endpoints return the bearer in the body's api_key field — write only that field to .env as SMARTERWEATHER_API_KEY=; never print it. Prefer the CLI / stdio sink.
3. A human opens the claim URL, signs in, accepts the developer terms, and claims. The same bearer continues to work as free.
4. After OAuth, claim_trial_key accepts a ticket without re-exposing the bearer.

Then: the weather MCP

Once your agent has a key (or a wallet), point it at the weather MCP — 36 tools for forecasts, alerts, radar, probabilistic guidance, and raw model data. See the tool reference.

claude mcp add smarterweather -- npx -y @smarterweather/mcp-weather@latest

{
  "mcpServers": {
    "smarterweather": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@smarterweather/mcp-weather@latest"
      ],
      "envFile": "${workspaceFolder}/.env"
    }
  }
}