Smarter Weather Developer Onboarding MCP server

Smarter Weather Developer Platform

The public home for the Smarter Weather developer platform: SDKs, documentation, example apps, the @smarterweather/mcp-weather and @smarterweather/mcp-onboarding packages, agent skills, and the OpenAPI specification for api.smarterweather.com.

Generally available. The REST API, both hosted MCP servers, and both npm

stdio bridges are live in production. Breaking-change policy: six months'

notice before removing a /v1/* endpoint or an MCP tool, 90 days before a

breaking change to a request or response shape. Non-breaking additions ship

immediately.

What lives here

https://api.smarterweather.com. Auto-synced from the canonical source on change. Also served at .

• OpenAPI specification (openapi.yaml) for the public REST API at

catalog for the weather MCP server, synced on every server change.

• MCP tool descriptors (descriptors/mcp-tools.json) -- the canonical

bridge that connects MCP clients (Cursor, Claude Desktop, Claude Code, etc.) to the hosted MCP endpoint at https://mcp.smarterweather.com. The bridge attaches your API key from SMARTERWEATHERAPIKEY and proxies every JSON-RPC message; all weather logic runs server-side.

• @smarterweather/mcp-weather -- npm package source for the stdio

bridge to the developer-onboarding MCP server at https://mcp.developers.smarterweather.com. Provides agent-driven self-service account creation, API key provisioning, and SDK setup walkthroughs. Auth via OAuth (browser callback).

• @smarterweather/mcp-onboarding -- npm package source for the stdio

shipped; call the REST API directly in the meantime.

• Client SDKs -- TypeScript and Python first; Go to follow. Not yet

end-to-end recipes.

• Examples and cookbooks -- runnable apps, agent integrations, and

is the long-lived Agent Plugins 1.0 package (weather MCP + playbooks). plugins/smarterweather-onboarding/ is the one-shot signup / key-mint install; remove it after configure_mcp. Never put both servers in one mcp.json. Cursor Marketplace discovery uses .cursor-plugin/marketplace.json. .cursor/skills/use-smarterweather-api/ is a pointer at the weather skills; .claude/CLAUDE.md remains a follow-up refresh.

• Agent Plugins -- plugins/smarterweather/

developer portal at https://developers.smarterweather.com. See the docs index for the current map.

• Documentation -- guides under docs/ that complement the

What does not live here: the Smarter Weather core service, ingestion pipeline, or any internal infrastructure. Those remain in a separate private repository.

Quickstart

The hosted developer portal at https://developers.smarterweather.com is the source of truth for account creation, API key minting, plan management, and usage. Agents can do all of it without the dashboard by connecting to the onboarding MCP server — see docs/mcp-onboarding.md.

Once you have a key:

# REST API
curl -H "Authorization: Bearer $SMARTERWEATHER_API_KEY" \
  "https://api.smarterweather.com/v1/weather?lat=41.88&lon=-87.63"

# Weather MCP bridge (defaults to https://mcp.smarterweather.com;

Shortened. The full README is on GitHub.