WeatherWithAttitude for Claude
Public documentation for the WeatherWithAttitude Claude connector.
What the connector does
The connector exposes one read-only tool, get_weather_roast, to Claude.ai, Claude Desktop and Claude Code. Given a city name, it returns the current temperature (°C) and conditions with a one-line joke about the weather, the next few hours in 3-hour steps, plus a link to a shareable card and a link to the Weather With Attitude website.
Where Claude supports interactive cards (MCP Apps), the answer also shows as a Weather With Attitude card styled like the website: the city, temperature, conditions, the roast, the attitude level (you can switch level in the card, which asks the tool again), a short “Coming up” strip and an “Open in Weather With Attitude” button. Elsewhere Claude shows the text answer. The card uses a second, app-only tool, record_card_event, that Claude’s model never sees, to report that it was shown or its button was opened.
It is for fun, not safety. It gives no warnings, alerts or multi-day forecasts. Severe conditions (tornado, blizzard, squall) are reported plainly, without a joke.
Parameters:
city(required) — a city name, optionally with region or country, up to 120 characters.attitude(optional) —wuss,midormost. Defaults towuss.
Example prompts:
- Roast the weather in London right now.
- Give me a Spicy weather roast for New York.
- What's the weather like in Tokyo? Keep it clean, but make it funny.
How to add the connector
The MCP server URL is:
https://www.weatherwithattitude.com/api/claude/mcp
No accounts, no API keys, no auth — just paste the URL.
Claude.ai (web)
- Open claude.ai and sign in.
- Go to Settings → Connectors.
- Click Add custom connector.
- Name:
WeatherWithAttitude. URL: paste the URL above. - Save and toggle the connector on.
- Start a new chat and try one of the example prompts above.
Claude Desktop
- Open Claude Desktop → Settings → Connectors → Add custom connector.
- Paste the same MCP URL. Save.
- Restart Claude Desktop if the tool does not appear immediately.
Older builds of Claude Desktop required a stdio config in claude_desktop_config.json. Modern builds support HTTP connectors directly — update Claude Desktop if you do not see the “custom connector” option.
Claude Code (CLI)
claude mcp add --transport http weather-attitude https://www.weatherwithattitude.com/api/claude/mcp
Then run claude mcp list to confirm the server is connected, and start a fresh claude session to use the tool.
Attitude levels
The roast comes in three levels, the same ones the website and apps use. The default is clean; stronger language is only used when someone asks for it.
- Wuss (default) (
wuss) — Clean, mildly sarcastic. No swearing. Used whenever no level is asked for. - Spicy (
mid) — Moderate swearing. Only when the person asks for it. - Brutal (
most) — Strong swearing. Only when the person asks for it.
Data handled
- Inputs: a city name passed by Claude (for example “London”). No personal data, no chat content.
- No accounts, no auth: the tool is anonymous. There is no OAuth, no API key on the user side, no per-user state stored anywhere.
- Third-party calls: the city is sent to OpenWeatherMap to look up coordinates, current conditions and a short forecast. The card loads its font, logo and weather pictures from weatherwithattitude.com and nothing else.
- Logs: standard Vercel request logs (timestamp, route, response code, IP). Used only to operate and rate-limit the service. No request bodies are persisted.
- Usage statistics: each tool call sends one anonymous event to PostHog: the attitude level, whether the city was found, success or error type, response time, connector version, the MCP client’s name and version when the client provides them, and a random per-connection id (one connection can cover several chats). The card adds two events with the same fields: card shown and website button opened. Events from our own testing are marked as tests. None of them includes any location (not your own, and not the city you asked about), your IP address, account, prompt, the city text or the roast.
- Website links: tagged
utm_source=claude; the plain links and the card’s button also carry the random per-connection id aswwa_cid, which the website strips from the address and uses only to count the visit with that conversation (new devices, after cookie consent). The share link never carries it.
See the privacy policy for full detail.
Rate limits
The endpoint enforces 60 requests per minute per IP. Excess requests receive a 429 Too Many Requests with a Retry-After header.
Each weather call performs at most one geocoding lookup, one current-conditions fetch and one short forecast fetch against OpenWeatherMap. The card’s usage events have their own allowance, so they never use up the weather one.
Security
- HTTPS only with managed TLS.
- Origin-header allowlist on the MCP endpoint —
claude.ai,*.anthropic.com, and missing/null Origin (Claude Desktop, server-to-server). All others rejected with 403. Defends against DNS rebinding per Anthropic’s MCP best practices. - Tool annotations declared:
readOnlyHint: true,destructiveHint: false,idempotentHint: true,openWorldHint: true.
Troubleshooting
- Connector won’t connect / “failed to add”. Confirm the URL is exactly
https://www.weatherwithattitude.com/api/claude/mcpwith no trailing slash. The server uses Streamable HTTP transport — SSE is not supported. - Tool isn’t appearing in chat. In Claude.ai, confirm the connector toggle is on for your conversation. In Claude Desktop, restart the app. In Claude Code, start a fresh
claudesession — existing sessions don’t pick up newly added MCP servers. - Tool runs but says “couldn’t find that city”. Try a more specific name (“London, UK” instead of “London” if the wrong city is matched). The connector uses OpenWeatherMap geocoding which prefers well-known city names.
- 429 / rate-limit error. You’re hitting the 60-requests-per-minute-per-IP cap. Wait 60 seconds and retry.
- 403 Forbidden response. Your client is sending an Origin header outside the allowlist (
claude.ai,*.anthropic.com, or empty). Browser dev tools and unsupported third-party clients will be rejected by design. - Roast text is too rude, or not rude enough. The default is the clean Wuss level. Ask Claude for a “Spicy” or “Brutal” roast to raise it, or for a clean one to bring it back down.
- Anything else. Email support@weatherwithattitude.com with the city you queried, the time of the request, and the error message if any.
Support
Bug reports, feature ideas, or content concerns: support@weatherwithattitude.com
Privacy or data-handling questions: privacy@weatherwithattitude.com