smarterweather-api

Use the Smarter Weather REST API

The platform offers two surfaces; pick the right one for the user's goal:

Goal	Use
Code that runs in production and calls weather endpoints from the user's own service	REST API (api.smarterweather.com/v1/*) — this skill
An AI agent that calls weather tools live during a chat session	MCP servers — see the smarterweather-mcp skill
One-time onboarding (account, key minting, client config)	@smarterweather/mcp-onboarding MCP — see the smarterweather-mcp skill

When in doubt, default to REST for code-generation tasks and MCP for agent-runtime tool calls.

Authentication — required reading

Every Smarter Weather request is authenticated with an API key. Never hard-code keys. Read them from the environment:

export SMARTERWEATHER_API_KEY="sw_live_..."

Hard rules:

• Never paste a key into chat history, prompts, or commit messages.
• Never commit a key to a repo, even temporarily. Smarter Weather participates in GitHub secret scanning; leaked keys are revoked automatically.
• Always use sw_test_* prefixed keys in tests, examples, and local dev scaffolds. Production code uses sw_live_*.
• Keys are minted, rotated, and revoked at https://developers.smarterweather.com/dashboard/api-keys, or by an agent through the onboarding MCP (create_api_key).

REST API

Shape

Item	Value
Base URL	https://api.smarterweather.com
Versioning	Path-based: /v1/*
Auth header	Authorization: Bearer $SMARTERWEATHER_API_KEY (the X-API-Key header is not supported)
Response content type	application/json; charset=utf-8 (success), application/problem+json (errors)
Machine-readable contract	https://developers.smarterweather.com/openapi.yaml

The OpenAPI document above is canonical. If an endpoint is not in it, the endpoint does not exist — don't fabricate.

Working example — TypeScript

const apiKey = process.env.SMARTERWEATHER_API_KEY;
if (!apiKey) {
  throw new Error("SMARTERWEATHER_API_KEY is not set");
}

const res = await fetch(
  "https://api.smarterweather.com/v1/weather?lat=41.88&lon=-87.63",
  {
    headers: {
      Authorization: `Bearer ${apiKey}`,
      Accept: "application/json",
    },
  },
);

if (!res.ok) {
  // Errors are RFC 7807 application/problem+json documents.
  const problem = await res.json().catch(() => ({}));
  throw new Error(
    `SmarterWeather ${res.status}: ${problem?.type ?? "unknown"} - ${problem?.detail ?? res.statusText}`,
  );
}

const weather = await res.json();