@smarterweather/mcp-onboarding
stdio bridge to the Smarter Weather developer onboarding MCP server — the agent-first way onto the Smarter Weather platform. Your AI coding agent can explore plans and docs, sign you up, mint API keys, configure your MCP client, and manage billing, all from inside your editor.
A thin wrapper around mcp-remote with Smarter Weather defaults. Discovery and account tools run server-side. start_trial is answered locally: the package mints over HTTPS, writes SMARTERWEATHER_API_KEY to .env (mode 0600), and returns only a 12-character key_prefix. Via the stdio bridge, hosted create_api_key / rotate_api_key also sink into .env and strip the plaintext. After upgrading the package, restart the MCP server so the new interceptor is loaded.
CLI (no MCP host)
Both write .env and print only a key prefix. login blocks until the human approves — run it in the background or with a long shell timeout and relay the printed URL. Pass --json for a single whitelisted object.
Quick start (anonymous)
No account, no key, no auth. The open discovery tools (get_plans, get_documentation, sign_up) work immediately:
Authenticated mode (account tools)
Set SMARTERWEATHER_ONBOARDING_AUTH=required to unlock the account-scoped tools (create_api_key, list_api_keys, rotate_api_key, revoke_api_key, configure_mcp, get_usage, get_billing_status, upgrade_plan, open_billing_portal). The first request triggers an OAuth 2.1 + PKCE browser sign-in (Clerk); tokens cache at ~/.mcp-auth/.
Production Clerk keeps Dynamic Client Registration off. The bridge uses a pre-registered public PKCE OAuth client (client_id baked into the package) and pins the mcp-remote loopback callback to http://localhost:3334/oauth/callback so it matches the Clerk app’s redirect URI. No client secret is required or shipped.
Ensure port 3334 is free when authenticating; if mcp-remote falls back to a random port, Clerk will reject the redirect.
Configuration
Any extra CLI arguments (--debug, --transport http-only, --header X:y, …) pass through verbatim to mcp-remote. If you already pass a callback port or --static-oauth-client-info, the bridge will not double-inject them.
--version prints the bridge version plus the bundled mcp-remote version and exits.
Looking for weather data?
This package onboards you to the platform. The weather data itself is served by @smarterweather/mcp-weather (hosted at mcp.smarterweather.com) — which configure_mcp will happily set up for you.
License
MIT