# Smarter Weather Developer Platform

> Weather data for apps and AI agents: a REST API (api.smarterweather.com), a
> hosted weather MCP server (mcp.smarterweather.com/mcp), and an agent-first
> onboarding MCP server (developers.smarterweather.com/mcp) that can sign you
> up, mint API keys, and configure your client — all from inside an AI agent.

Agents onboarding a developer should start with the onboarding MCP server:
connect anonymously to https://developers.smarterweather.com/mcp (Streamable
HTTP, no credentials) and call get_plans / get_documentation / sign_up.
Account-scoped tools (API key minting, billing) unlock after OAuth 2.1 sign-in.

## Machine-readable contracts

- [OpenAPI specification](https://developers.smarterweather.com/openapi.yaml): full machine-readable contract for api.smarterweather.com
- [Weather MCP tool descriptors](https://developers.smarterweather.com/.well-known/mcp-tools.json): the 28-tool catalog for mcp.smarterweather.com
- [Agent Skills index](https://developers.smarterweather.com/.well-known/skills/index.json): installable SKILL.md skills for this platform
- [smarterweather-api skill](https://developers.smarterweather.com/.well-known/skills/smarterweather-api/SKILL.md): REST integration guidance for agents
- [smarterweather-mcp skill](https://developers.smarterweather.com/.well-known/skills/smarterweather-mcp/SKILL.md): MCP install, onboarding flow, x402 keyless access

## Docs

- [Built for agents](https://developers.smarterweather.com/agents): one-click MCP installs, onboarding flow, agentic payments
- [Quickstart](https://developers.smarterweather.com/quickstart): mint a key and make your first REST and MCP calls
- [REST API guide](https://developers.smarterweather.com/api): auth, endpoints, rate-limit headers
- [API reference](https://developers.smarterweather.com/api/reference): interactive reference rendered from the OpenAPI spec
- [Weather MCP server guide](https://developers.smarterweather.com/mcp-server): hosted endpoint, tool catalog, stdio bridge (@smarterweather/mcp-weather)
- [MCP setup guide](https://developers.smarterweather.com/mcp-server/setup): client configuration for Cursor, Claude Code, VS Code, and others
- [MCP tool reference](https://developers.smarterweather.com/mcp-server/tools): per-tool inputs and outputs
- [Developer pricing](https://developers.smarterweather.com/pricing): tiers, quotas, and keyless (x402) pay-per-call
- [Error model](https://developers.smarterweather.com/api): RFC 7807 problem details and retry semantics

## Optional

- [Public developer repo](https://github.com/smarterweather/developer): mirrored contracts, guides, and issue templates
- [Developer terms](https://developers.smarterweather.com/legal/terms)
- [Acceptable use](https://developers.smarterweather.com/legal/acceptable-use)