Timezone Converter X402

by Br0ski777

553 downloads
Not rated
GitHub

About

Convert datetime between timezones -- all IANA zones, UTC offset, DST-aware. ISO 8601 input/output. -- x402 micropayment API + MCP server for AI agents

Details

Author
Br0ski777
Downloads
553
Categories
Other

- Convert datetime between any IANA timezones
- DST-aware with UTC offset and abbreviation
- ISO 8601 input and output
- Pay-per-call via x402, no signup needed
- Single MCP tool: utility_convert_timezone
- Part of a marketplace of 100+ x402 APIs

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Timezone Converter X402
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add the MCP server URL to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.). For direct HTTP access, POST a JSON body with datetime, from, and to fields to the /api/convert endpoint. An x402-aware client (e.g., @x402/fetch) automatically handles the 402 payment challenge.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "timezone converter x402": {
            "timezone-converter": {
                "url": "https://timezone-converter-production-d3c5.up.railway.app/mcp",
                "transport": "sse"
            }
        }
    }
}

McpServers

{
    "timezone-converter": {
        "url": "https://timezone-converter-production-d3c5.up.railway.app/mcp",
        "transport": "sse"
    }
}

Timezone Converter API

MCP Server
x402
License: MIT

Convert datetime between timezones -- all IANA zones, UTC offset, DST-aware. ISO 8601 input/output. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "timezone-converter": {
      "url": "https://timezone-converter.api.klymax402.com/mcp"
    }
  }
}

Quickstart -- HTTP (x402)

curl -X POST "https://timezone-converter.api.klymax402.com/api/convert" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"...","from":"...","to":"..."}'

-> 402 Payment Required, with an x402 payment challenge in the response body

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
| utility_convert_timezone | POST | /api/convert | $0.001 | Convert a datetime between timezones |

utility_convert_timezone

Use this when you need to convert a date/time from one timezone to another. Returns the converted datetime with offset data in JSON.

Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| datetime | string | yes | Date/time string (ISO 8601 or human-readable, e.g. '2024-01-15T14:30:00') |
| from | string | yes | Source IANA timezone (e.g. America/New_York) |
| to | string | yes | Target IANA timezone (e.g. Europe/Paris) |

Example response:

{"originalDatetime":"2026-04-13T14:30:00","fromTimezone":"America/New_York","toTimezone":"Europe/Paris","convertedDatetime":"2026-04-13T20:30:00","utcOffset":"+02:00","abbreviation":"CEST","isDST":true}

When to use: scheduling meetings across timezones, converting log timestamps, coordinating international events, and displaying local times.

Not for: currency conversion (use finance_convert_currency), unit conversion (use utility_convert_units), weather data (use data_get_weather).

Example agent prompts

- "Convert a date/time from one timezone to another"

Payment

- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (eip155:8453)
- Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
- Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.