Remote MCP Server: User Timezone Tool

This Cloudflare Worker deploys a remote MCP server (authless) with a single tool: it returns the user's timezone based on their IP address when called from a remote MCP client.

How it Works

• Implements an MCP-compliant server using the agents and @modelcontextprotocol/sdk packages.
• Defines a single "get_timezone" tool: when invoked from an MCP client (e.g. Claude Desktop, or AI Playground), it attempts to infer the timezone of the user based on their IP address (from Cloudflare headers or forwarded headers).

Fast Deploy

This will deploy your MCP server to a URL like: user-timezone-mcp-server.<your-account>.workers.dev/sse

Usage (MCP Tool)

• Tool name: get_timezone
• No parameters required
• Returns the user's timezone as a text message

Local Testing (Curl Example)

Try the health endpoint directly:

curl "https://user-timezone-mcp-server.<your-account>.workers.dev/timezone"

Response:

{"timezone":"America/Los_Angeles","ip":"203.0.113.99"}

Where available, the endpoint will return your timezone and detected IP address. In development or local wrangler, IP-based detection may not function.

Connect Using Claude Desktop or Playground

• Claude Desktop: Use the mcp-remote proxy, set your config for /sse endpoint.
• Playground: Add your /sse endpoint in the UI, click get_timezone.

Security/Privacy Considerations

• Only the user's apparent public IP address (via standard headers) is used for time zone lookup.
• No data is retained or logged except for error logging (for diagnostics only).
• No authentication is enabled—this is a public MCP endpoint intended for experimentation and utility functions.

Customize Tools

To add more tools or behaviors, edit the init() method of src/index.ts and register additional MCP tools to this.server.