weltze.it

Für Entwickler und KI-Assistenten

Zeitzonen-API und MCP-Server

Aktuelle Uhrzeiten, Zeitverschiebungen, Zeitumstellungen und Umrechnungen als kostenlose JSON-API und als MCP-Server für Claude, ChatGPT, Cursor und andere KI-Werkzeuge. Ohne Anmeldung, ohne Schlüssel.

JSON-API

Basis-URL https://weltze.it/api/v1. Alle Endpunkte nehmen Ortsnamen auf Deutsch oder Englisch („San Diego“, „München“), Zeitzonennamen („Central Time“, „MEZ“) oder IANA-Zeitzonen („America/Chicago“). Antworten sind JSON, CORS ist freigegeben.

curl "https://weltze.it/api/v1/time?zone=San%20Diego"

GET /api/v1/time

Ortszeit, UTC-Offset, Sommerzeit und nächste Zeitumstellung.

zone
Ort oder Zeitzone (Pflicht)
at
Zeitpunkt nach ISO 8601, Standard: jetzt

/api/v1/time?zone=Central%20Time

GET /api/v1/difference

Zeitverschiebung jetzt und ihre Änderungen durch Zeitumstellungen.

from
Bezugsort (Pflicht)
to
Vergleichsort (Pflicht)
at
Zeitpunkt, Standard: jetzt
months
Zeitraum für Änderungen, 1–24, Standard 12

/api/v1/difference?from=Berlin&to=New%20York

GET /api/v1/convert

Uhrzeit umrechnen; meldet nicht existierende und doppelte Uhrzeiten bei der Zeitumstellung.

time
Lokale Uhrzeit, z. B. 2026-12-01T13:30 (Pflicht)
from
Ort der angegebenen Uhrzeit (Pflicht)
to
Zielort (Pflicht)
disambiguation
earlier oder later für doppelte Stunden

/api/v1/convert?time=2026-12-01T13:30&from=M%C3%BCnchen&to=Tokio

Orte, Zeitzonennamen und Abkürzungen suchen.

q
Suchtext (Pflicht)
limit
1–25, Standard 10

/api/v1/search?q=IST

MCP-Server

Remote-MCP-Server (Streamable HTTP) unter https://weltze.it/mcp mit den Werkzeugen get_time, time_difference, convert_time und search_places. In Claude oder ChatGPT als benutzerdefinierten Connector mit dieser URL hinzufügen; in Cursor, Claude Code und ähnlichen Werkzeugen so:

{
  "mcpServers": {
    "weltze-it": {
      "type": "http",
      "url": "https://weltze.it/mcp"
    }
  }
}
claude mcp add --transport http weltze-it https://weltze.it/mcp

Nutzung und Grenzen

Kostenlos und ohne Schlüssel. Pro IP-Adresse ist die Zahl der Anfragen begrenzt; bei Überschreitung antwortet der Server kurz mit HTTP 429. Antworten werden 30 Sekunden zwischengespeichert. Anfragen werden ohne Cookies und mit anonymisierter Kennung statistisch ausgewertet. Die Version v1 bleibt kompatibel.

Häufige Fragen

Kostet die API etwas?

Nein. API und MCP-Server sind kostenlos und brauchen keinen Schlüssel. Pro IP-Adresse gilt ein Limit; wer es überschreitet, bekommt kurz HTTP 429.

Woher stammen die Daten?

Zeitzonen aus der IANA tz database (derzeit 2026f, monatlich automatisch aktualisiert), Städte von GeoNames (CC BY 4.0). Bitte bei Nutzung der Städtedaten GeoNames nennen.

Warum nicht einfach die Zeitzonen des eigenen Systems nutzen?

Betriebssysteme, Browser und KI-Modelle haben oft veraltete Zeitzonendaten. 2026 haben etwa Teile Kanadas, Marokko und Kuba ihre Regeln geändert; weltze.it rechnet mit dem aktuellen Stand.