MCP server
What this is
This application is an MCP server over Streamable HTTP (remote only). Every public API operation is available to an AI assistant as a tool.
Endpoint
Use this URL in your MCP client. These aliases reach the same endpoint:
https://wthr.top/api/v1/server/mcp
https://wthr.top/api/mcphttps://wthr.top/mcp
Authentication
Requests authenticate with Authorization: Bearer {token}, the same tokens as the REST API. Anonymous access works for public tools. Create a dedicated named token for each client in your account's token settings with scope read or read-write and an expiry, so it can be revoked alone. Use an admin token only for a server-admin tool, never for a general MCP client.
Connect a client
Set MCP_TOKEN to your token first; it is the only value this page cannot know.
Claude Code
claude mcp add --transport http wthr https://wthr.top/api/v1/server/mcp --header "Authorization: Bearer $MCP_TOKEN"
Generic JSON client configuration
{"mcpServers": {"wthr": {"type": "http", "url": "https://wthr.top/api/v1/server/mcp", "headers": {"Authorization": "Bearer $MCP_TOKEN"}}}}
Verify the connection with curl
curl -q -LSsf -X POST https://wthr.top/api/v1/server/mcp -H "Authorization: Bearer $MCP_TOKEN" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'
Tools
Tools available without signing in. Signed-in callers may see more.
get*- GET /api/v1/*/ (main.main.func104)get*Docs- GET /api/v1/*/docs (src/server/handler.(*APIHandler).GetDocsJSON-fm)get*Earthquakes- GET /api/v1/*/earthquakes (src/server/handler.(*EarthquakeHandler).HandleEarthquakeAPI-fm)get*EarthquakesId- GET /api/v1/*/earthquakes/{id} (src/server/handler.(*EarthquakeHandler).HandleEarthquakeByIDAPI-fm)get*Forecasts- GET /api/v1/*/forecasts (src/server/handler.(*APIHandler).GetForecast-fm)get*ForecastsLocation- GET /api/v1/*/forecasts/{location} (src/server/handler.(*APIHandler).GetForecastByLocation-fm)get*History- GET /api/v1/*/history (src/server/handler.(*APIHandler).GetHistoricalWeather-fm)get*Hurricanes- GET /api/v1/*/hurricanes (src/server/handler.(*HurricaneHandler).HandleHurricaneAPI-fm)get*HurricanesId- GET /api/v1/*/hurricanes/{id} (src/server/handler.(*HurricaneHandler).HandleHurricaneByIDAPI-fm)get*Ip- GET /api/v1/*/ip (src/server/handler.(*APIHandler).GetIP-fm)get*Moon- GET /api/v1/*/moon (src/server/handler.(*MoonHandler).HandleMoonAPI-fm)get*MoonCalendar- GET /api/v1/*/moon/calendar (src/server/handler.(*MoonHandler).HandleMoonCalendarAPI-fm)get*SevereWeather- GET /api/v1/*/severe-weather (src/server/handler.(*SevereWeatherHandler).HandleSevereWeatherAPI-fm)get*SevereWeatherId- GET /api/v1/*/severe-weather/{id} (src/server/handler.(*SevereWeatherHandler).HandleAlertByIDAPI-fm)get*Sun- GET /api/v1/*/sun (src/server/handler.(*MoonHandler).HandleSunAPI-fm)get*Weather- GET /api/v1/*/weather (src/server/handler.(*APIHandler).GetWeather-fm)get*WeatherAlerts- GET /api/v1/*/weather/alerts (src/server/handler.(*SevereWeatherHandler).HandleSevereWeatherAPI-fm)get*WeatherForecast- GET /api/v1/*/weather/forecast (src/server/handler.(*APIHandler).GetForecast-fm)get*WeatherHistory- GET /api/v1/*/weather/history (src/server/handler.(*APIHandler).GetHistoricalWeather-fm)get*WeatherLocation- GET /api/v1/*/weather/{location} (src/server/handler.(*APIHandler).GetWeatherByLocation-fm)get*WeatherLocations- GET /api/v1/*/weather/locations (src/server/handler.(*APIHandler).GetLocation-fm)get*WeatherMoon- GET /api/v1/*/weather/moon (src/server/handler.(*MoonHandler).HandleMoonAPI-fm)getBlocklist- GET /api/v1/blocklist (main.main.func105)getLocationsLookupCoords- GET /api/v1/locations/lookup/coords (src/server/handler.(*LocationHandler).LookupCoordinates-fm)getLocationsLookupZipCode- GET /api/v1/locations/lookup/zip/{code} (src/server/handler.(*LocationHandler).LookupZipCode-fm)getLocationsSearch- GET /api/v1/locations/search (src/server/handler.(*LocationHandler).SearchLocations-fm)getPublicUsersUsername- GET /api/v1/public/users/{username} (src/server/handler.(*UserPublicHandler).GetPublicProfile-fm)getServerAbout- GET /api/v1/server/about (src/server/handler.GetAboutAPI.func1)getServerAuthCheck- GET /api/v1/server/auth/check (src/server/handler.HandleAuthCheck.func1)getServerAuthInviteServerToken- GET /api/v1/server/auth/invite/server/{token} (src/server/handler.(*AuthAPIHandler).HandleAPIServerInviteValidate-fm)getServerAuthInviteUserToken- GET /api/v1/server/auth/invite/user/{token} (src/server/handler.(*AuthAPIHandler).HandleAPIUserInviteValidate-fm)getServerContact- GET /api/v1/server/contact (src/server/handler.GetContactFormAPI.func1)getServerDpo- GET /api/v1/server/dpo (src/server/handler.GetDPOAPI.func1)getServerHealthz- GET /api/v1/server/healthz (src/server/handler.APIHealthCheck.func1)getServerHelp- GET /api/v1/server/help (src/server/handler.GetHelpAPI.func1)getServerHelpMcp- GET /api/v1/server/help/mcp (src/server/handler.GetMCPHelpAPI.func1)getServerMetrics- GET /api/v1/server/metrics (src/server/handler.(*MetricsHandler).ServeMetricsService-fm)getServerMetricsService- GET /api/v1/server/metrics/{service} (src/server/handler.(*MetricsHandler).ServeMetricsService-fm)getServerPreferences- GET /api/v1/server/preferences (src/server/handler.(*PreferencesHandler).ExportCurrentPreferences-fm)getServerPreferencesExport- GET /api/v1/server/preferences/export (src/server/handler.(*PreferencesHandler).ExportPreferences-fm)getServerPreferencesImport- GET /api/v1/server/preferences/import (src/server/handler.(*PreferencesHandler).ImportPreferences-fm)getServerPrivacy- GET /api/v1/server/privacy (src/server/handler.GetPrivacyAPI.func1)getServerSecurity- GET /api/v1/server/security (src/server/handler.GetSecurityAPI.func1)getServerSecurityPolicy- GET /api/v1/server/security/policy (src/server/handler.GetSecurityPolicyAPI.func1)getServerSecurityThanks- GET /api/v1/server/security/thanks (src/server/handler.GetSecurityThanksAPI.func1)getServerSwagger- GET /api/v1/server/swagger (src/mcp.(*Server).OpenAPI-fm)getServerTerms- GET /api/v1/server/terms (src/server/handler.GetTermsAPI.func1)postServerAuth2fa- POST /api/v1/server/auth/2fa (src/server/handler.(*AuthAPIHandler).HandleAPI2FA-fm)postServerAuthAdminPasskeyChallenge- POST /api/v1/server/auth/admin/passkey/challenge (src/server/handler.(*AdminPasskeyHandler).BeginPasskeyChallenge-fm)postServerAuthAdminPasskeyVerify- POST /api/v1/server/auth/admin/passkey/verify (src/server/handler.(*AdminPasskeyHandler).VerifyPasskey-fm)postServerAuthInviteServerToken- POST /api/v1/server/auth/invite/server/{token} (src/server/handler.(*AuthAPIHandler).HandleAPIServerInviteComplete-fm)postServerAuthInviteUserToken- POST /api/v1/server/auth/invite/user/{token} (src/server/handler.(*AuthAPIHandler).HandleAPIUserInviteComplete-fm)postServerAuthLogin- POST /api/v1/server/auth/login (src/server/handler.(*AuthAPIHandler).HandleAPILogin-fm)postServerAuthPasskeyChallenge- POST /api/v1/server/auth/passkey/challenge (src/server/handler.(*PasskeyHandler).BeginPasskeyChallenge-fm)postServerAuthPasskeyVerify- POST /api/v1/server/auth/passkey/verify (src/server/handler.(*PasskeyHandler).VerifyPasskey-fm)postServerAuthPasswordForgot- POST /api/v1/server/auth/password/forgot (src/server/handler.(*AuthAPIHandler).HandleAPIPasswordForgot-fm)postServerAuthPasswordReset- POST /api/v1/server/auth/password/reset (src/server/handler.(*AuthAPIHandler).HandleAPIPasswordReset-fm)postServerAuthRecoveryUse- POST /api/v1/server/auth/recovery/use (src/server/handler.(*AuthAPIHandler).HandleAPIRecoveryUse-fm)postServerAuthRegister- POST /api/v1/server/auth/register (src/server/handler.(*AuthAPIHandler).HandleAPIRegister-fm)postServerAuthVerify- POST /api/v1/server/auth/verify (src/server/handler.(*AuthAPIHandler).HandleAPIVerifyEmail-fm)postServerContact- POST /api/v1/server/contact (src/server/handler.HandleContactFormSubmission.func1)postServerGraphql- POST /api/v1/server/graphql (src/graphql.GraphQLHandler.func1)postServerPreferences- POST /api/v1/server/preferences (src/server/handler.(*PreferencesHandler).SavePreferences-fm)
Behavior and limits
POST only. No sessions. The same rate limits and audit as the API. The Origin header is validated. Supported protocol versions are negotiated by the client.
Troubleshooting
| Status | Meaning and fix |
|---|---|
| 400 | Protocol version or header mismatch. Update the client or send the MCP-Protocol-Version header. |
| 401 | Missing, invalid or expired token. Send Authorization: Bearer with a valid token. |
| 403 | Bad Origin or insufficient token scope. Use a token with the needed scope. |
| 404 | MCP is disabled on this server. |
| 405 | GET and DELETE are not supported. The endpoint is POST only. |