by smarterweather · TypeScript
Agent-first onboarding to Smarter Weather: plans, docs, signup, API keys, MCP config, billing.
Agent-first onboarding to Smarter Weather: plans, docs, signup, API keys, MCP config, billing.
Captured live from the server via tools/list.
Current developer-platform plans and pricing: Free, Developer, and Professional tiers with monthly price, included API-call allowance, and overage rates. One metered allowance spans REST and MCP usage. No authentication required.
Parameters
No parameters.
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Search the Smarter Weather developer documentation index (quickstart, REST API, MCP server, errors, rate limits, SDKs, pricing, API keys). Returns up to 5 matching entries with title, URL, and an actionable summary. No authentication required.
| query | string | required | Search terms, e.g. "authenticate rest api" (max 200 chars) |
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Search terms, e.g. \"authenticate rest api\" (max 200 chars)"
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Returns the Smarter Weather developer signup URL (with MCP referral attribution). Signup is a web flow: present the URL to the user and ask them to complete it in a browser, then authenticate this MCP server via OAuth to continue onboarding (key minting, client configuration). No authentication required.
Parameters
No parameters.
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}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. All onboarding logic runs server-side.
No account, no key, no auth. The open discovery tools (get_plans, get_documentation, sign_up) work immediately:
{
"mcpServers": {
"smarterweather-onboarding": {
"command": "npx",
"args": ["-y", "@smarterweather/mcp-onboarding"]
}
}
}
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.
{
"mcpServers": {
"smarterweather-onboarding": {
"command": "npx",
"args": ["-y", "@smarterweather/mcp-onboarding"],
"env": {
"SMARTERWEATHER_ONBOARDING_AUTH": "required"
}
}
}
}
Ensure port 3334 is free when authenticating; if mcp-remote falls back to a random port, Clerk will reject the redirect.
| Env var | Default | Purpose |
|---|---|---|
SMARTERWEATHER_ONBOARDING_MCP_URL | https://developers.smarterweather.com/mcp | Target endpoint override (dev/staging). A positional URL argument takes precedence over both. |
SMARTERWEATHER_ONBOARDING_AUTH | (unset) | required → opt into the OAuth challenge and account-scoped tools. |
SMARTERWEATHER_ONBOARDING_OAUTH_CLIENT_ID | PQcxOLVZg5kxzhoC | Override the pre-registered Clerk OAuth client_id (staging / alternate apps). |
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.
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.
SMARTERWEATHER_ONBOARDING_AUTHSet to 'required' to opt into OAuth 2.1 + PKCE sign-in and unlock account-scoped tools (API key minting, usage, billing). Unset, the bridge serves the anonymous discovery tools (get_plans, get_documentation, sign_up) with no credentials at all.
SMARTERWEATHER_ONBOARDING_MCP_URLdefault https://developers.smarterweather.com/mcpOverride the target MCP endpoint for development or staging. Precedence: positional argument > SMARTERWEATHER_ONBOARDING_MCP_URL > package default.
claude_desktop_config.json
{
"mcpServers": {
"onboarding": {
"command": "npx",
"args": [
"-y",
"@smarterweather/mcp-onboarding@0.0.1"
],
"env": {
"SMARTERWEATHER_ONBOARDING_AUTH": "<YOUR_SMARTERWEATHER_ONBOARDING_AUTH>",
"SMARTERWEATHER_ONBOARDING_MCP_URL": "https://developers.smarterweather.com/mcp"
}
}
}
}