How to Use the TimezoneDB MCP in Cline

Let Cline build timezone-aware features by fetching live offsets directly inside VS Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect TimezoneDB MCP to Cline

Create your Vinkius account to connect TimezoneDB to Cline — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup TimezoneDB with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Build Location-Aware Features

Cline triggers `get_time_by_location` to pull the exact current time for any geographic coordinate pair. If you tell the agent to build a delivery tracking dashboard, it fetches the real local time for the driver's GPS ping. The agent takes that raw data and writes the formatting functions straight into your TypeScript files. You watch the diff appear in VS Code as the MCP server wires the backend response to your frontend components.

Handle DST Transitions Automatically

Figuring out daylight saving rules manually causes production outages, so the agent relies on `get_dst_status` to check if a specific zone is currently shifted. It reads the boolean response and writes the necessary conditional logic into your application. For broader regional support, it uses `get_time_by_zone` to grab the baseline offset for places like Europe/London. Cline writes the tests, mocks the API response, and proves the timezone math works before you commit the code.

Validate Upstream MCP Server Health

Network calls fail, which is why your agent runs `check_api_status` before attempting to sync a massive block of temporal data. It verifies the external service is operational to prevent hanging your build process. When you need to seed a database, it executes `list_timezones` to pull the complete array of global regions. Cline parses that JSON array and generates the SQL insert statements without you typing a single line.

Setup guide

Set up TimezoneDB MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type timezonedb-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest TimezoneDB refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "timezonedb-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TimezoneDB. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect TimezoneDB now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about TimezoneDB MCP in Cline

Open the sidebar in VS Code and click the MCP Servers icon. You can use the Remote Servers tab to add the URL or edit your configuration file directly.

The agent reads the live offset data and generates the exact code needed for your project. It imports the data, creates the functions, and stages the files.

The list tool accepts country codes as arguments. You tell the agent you only want Canadian zones, and it passes that parameter automatically.

This integration provides live server-side validation for current times and offsets. You still use local libraries for formatting, but the agent uses the server to verify the actual math.

The agent only transmits the specific region names or coordinates it needs to check. Your proprietary application code remains local, and Vinkius enforces strict zero-trust boundaries around the external requests.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript