{
  "markdown": "# Smarter Weather Developer Platform\n\nThe public home for the Smarter Weather developer platform: SDKs,\ndocumentation, example apps, the `@smarterweather/mcp-weather` and\n`@smarterweather/mcp-onboarding` packages, agent skills, and the OpenAPI\nspecification for `api.smarterweather.com`.\n\n> **Generally available.** The REST API, both hosted MCP servers, and both npm\n> stdio bridges are live in production. Breaking-change policy: six months'\n> notice before removing a `/v1/*` endpoint or an MCP tool, 90 days before a\n> breaking change to a request or response shape. Non-breaking additions ship\n> immediately.\n\n| Surface | Endpoint | Auth |\n| ------- | -------- | ---- |\n| REST API | `https://api.smarterweather.com` | `Authorization: Bearer sw_live_*` / `sw_test_*` |\n| Weather MCP | `https://mcp.smarterweather.com` | API key Bearer, OAuth 2.1 + PKCE, or keyless x402 |\n| Onboarding MCP | `https://mcp.developers.smarterweather.com` | Anonymous discovery tools; OAuth for account tools |\n\n---\n\n## What lives here\n\n- **OpenAPI specification** (`openapi.yaml`) for the public REST API at\n  `https://api.smarterweather.com`. Auto-synced from the canonical source on\n  change. Also served at\n  <https://developers.smarterweather.com/openapi.yaml>.\n- **MCP tool descriptors** (`descriptors/mcp-tools.json`) -- the canonical\n  catalog for the weather MCP server, synced on every server change.\n- **`@smarterweather/mcp-weather`** -- npm package source for the stdio\n  bridge that connects MCP clients (Cursor, Claude Desktop, Claude Code, etc.)\n  to the hosted MCP endpoint at `https://mcp.smarterweather.com`. The\n  bridge attaches your API key from `SMARTERWEATHER_API_KEY` and proxies\n  every JSON-RPC message; all weather logic runs server-side.\n- **`@smarterweather/mcp-onboarding`** -- npm package source for the stdio\n  bridge to the developer-onboarding MCP server at\n  `https://mcp.developers.smarterweather.com`. Provides agent-driven\n  self-service account creation, API key provisioning, and SDK setup\n  walkthroughs. Auth via OAuth (browser callback).\n- **Client SDKs** -- TypeScript and Python first; Go to follow. Not yet\n  shipped; call the REST API directly in the meantime.\n- **Examples and cookbooks** -- runnable apps, agent integrations, and\n  end-to-end recipes.\n- **Agent Plugins** -- [`plugins/smarterweather/`](./plugins/smarterweather/)\n  is the long-lived [Agent Plugins 1.0](https://agent-plugins.org/) package\n  (weather MCP + playbooks).\n  [`plugins/smarterweather-onboarding/`](./plugins/smarterweather-onboarding/)\n  is the one-shot signup / key-mint install; remove it after\n  `configure_mcp`. Never put both servers in one `mcp.json`. Cursor\n  Marketplace discovery uses\n  [`.cursor-plugin/marketplace.json`](./.cursor-plugin/marketplace.json).\n  [`.cursor/skills/use-smarterweather-api/`](./.cursor/skills/use-smarterweather-api/SKILL.md)\n  is a pointer at the weather skills; [`.claude/CLAUDE.md`](./.claude/CLAUDE.md)\n  remains a follow-up refresh.\n- **Documentation** -- guides under [`docs/`](./docs/) that complement the\n  developer portal at https://developers.smarterweather.com. See the\n  [docs index](./docs/README.md) for the current map.\n\nWhat does **not** live here: the Smarter Weather core service, ingestion\npipeline, or any internal infrastructure. Those remain in a separate private\nrepository.\n\n## Quickstart\n\nThe hosted developer portal at https://developers.smarterweather.com is\nthe source of truth for account creation, API key minting, plan management,\nand usage. Agents can do all of it without the dashboard by connecting to the\nonboarding MCP server — see [docs/mcp-onboarding.md](./docs/mcp-onboarding.md).\n\nOnce you have a key:\n\n```bash\n# REST API\ncurl -H \"Authorization: Bearer $SMARTERWEATHER_API_KEY\" \\\n  \"https://api.smarterweather.com/v1/weather?lat=41.88&lon=-87.63\"\n```\n\n```bash\n# Weather MCP bridge (defaults to https://mcp.smarterweather.com;\n# override via SMARTERWEATHER_MCP_URL).\nnpx -y @smarterweather/mcp-weather --version\n```\n\nThe full quickstart with language-specific snippets lives at\nhttps://developers.smarterweather.com/quickstart. Agents should start from\n[`llms.txt`](./llms.txt) or [`AGENTS.md`](./AGENTS.md).\n\n## Getting help\n\n- **Bug reports and feature requests** -- file an issue on this repo using\n  the templates in the issue chooser.\n- **API contract questions** -- file an issue with the \"API contract\n  question\" template; these route to the team that owns the public surface.\n- **General \"how do I do X?\" questions** -- start a thread in\n  [Discussions](https://github.com/smarterweather/developer/discussions). We\n  prefer Discussions over chat platforms because answers stay searchable.\n- **Account, billing, or commercial inquiries** -- email\n  alex@smarterweather.com or use the [contact\n  page](https://smarterweather.com/contact).\n- **Security issues** -- see [SECURITY.md](./SECURITY.md). Please do not\n  open public issues for security reports.\n\n## Roadmap\n\nSmarter Weather built the developer platform in phases; this repo publishes\nartifacts as each one ships.\n\n| Phase | Surface | Status |\n| ----- | ------- | ------ |\n| 1a | Developer dashboard, API key CRUD, billing, monitoring | shipped |\n| 1b | This public repository (contracts, package sources, OpenAPI + descriptor sync) | shipped |\n| 2  | Public REST API (`sw-api`) at `api.smarterweather.com` with usage-based billing | shipped |\n| 2b | First-party migration of the Smarter Weather web and iOS apps onto the public API | shipped |\n| 3  | Public MCP server (`sw-mcp`) at `mcp.smarterweather.com` + `@smarterweather/mcp-weather` | shipped |\n| 4  | Onboarding MCP server (`sw-onboarding`) + `@smarterweather/mcp-onboarding` | shipped |\n| 5  | SDKs, expanded examples, registry distribution, community growth | in progress |\n\nThe roadmap is published for transparency, not as a commitment. Dates are\nintentionally omitted -- watch this repository for releases.\n\n## Contributing\n\nExternal contributions are welcome on a tiered basis (typo and small SDK\nfixes are fast-tracked; new features start with an issue). The OpenAPI\nspecification is read-only -- contract changes route through issues.\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for the full posture and the\n[Code of Conduct](./CODE_OF_CONDUCT.md) for community expectations.\n\n## License\n\n- **Code** -- SDKs, examples, the `@smarterweather/mcp-weather` and\n  `@smarterweather/mcp-onboarding` package sources, and any agent skills or\n  scaffolding are licensed under the [MIT License](./LICENSE).\n- **Documentation and prose** -- this README, anything under `docs/`, and\n  `openapi.yaml` (when present) are licensed under [Creative Commons\n  Attribution 4.0 International](./LICENSE-docs).\n\nWhere any file's intended license is ambiguous (for example, a tutorial that\nmixes prose and code samples), assume MIT for the code blocks and CC BY 4.0\nfor the surrounding prose.\n\nThe Smarter Weather hosted APIs and services themselves are governed by\nseparate Terms of Service and Developer Terms at\nhttps://smarterweather.com/terms and\nhttps://developers.smarterweather.com/legal/terms.\nThis repository contains client-side and documentation artifacts only; access\nto the hosted APIs requires a separate agreement.\n\n## Attribution\n\nSmarter Weather builds on data and software from many providers. See\n[ATTRIBUTION.md](./ATTRIBUTION.md) for the canonical acknowledgements list.\n",
  "bytes": 7389,
  "sha": "d5db392518ad0ed1bdda45c0a943fc756088f6975116ce0b2e1c3f0d042df0e3",
  "repo_slug": "smarterweather/developer",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_smarterweather_weather_059ed2df/readme"
}