Back to Help

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

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.

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

StatusMeaning and fix
400Protocol version or header mismatch. Update the client or send the MCP-Protocol-Version header.
401Missing, invalid or expired token. Send Authorization: Bearer with a valid token.
403Bad Origin or insufficient token scope. Use a token with the needed scope.
404MCP is disabled on this server.
405GET and DELETE are not supported. The endpoint is POST only.