Agent verbinden

Deinen Agenten in wenigen Minuten verbinden.

Danach kann er Verbindungen planen, Abfahrten prüfen und Haltestellen in Deutschland finden - mit echten Fahrplandaten, kostenlos und ohne Account.

1 · Editor wählen und MCP einfügen

Wähle deinen Editor unten, kopiere die Konfiguration, und starte den Client neu.

SKILL.md

Diese Einrichtung ist für Agenten in Cursor, Claude, Codex und anderen unterstützten Editoren. Wenn du nur im Terminal arbeitest, genügt die CLI.

Plugin mit Skill und MCP-Konfiguration.

./imtakt-plugin/

1 · Skill installieren

zsh

mkdir -p imtakt-plugin/.codex-plugin imtakt-plugin/skills/imtakt/agents

cat > imtakt-plugin/.codex-plugin/plugin.json <<'IMTAKT_EOF'
{
  "name": "imtakt",
  "version": "0.3.1",
  "description": "Deutsche Verkehrsdaten für Codex: Fahrten, Abfahrten und Zugläufe ohne Account.",
  "author": {
    "name": "ImTakt",
    "url": "https://imtakt.dev"
  },
  "homepage": "https://imtakt.dev",
  "repository": "https://github.com/ImTakt/imtakt",
  "license": "MIT",
  "keywords": [
    "bahn",
    "deutschland",
    "rail",
    "gtfs",
    "transit",
    "db",
    "germany"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "ImTakt",
    "shortDescription": "Deutsche Verkehrsdaten für deinen Agenten",
    "longDescription": "Plans journeys across German public transit — long-distance and regional trains, S-Bahn, U-Bahn, tram, and bus — reads live departure boards, resolves stations, and shows live train run stats. Use when the user asks about getting around Germany by train or public transit, Deutsche Bahn schedules, connections, delays, platforms, or journey duration between German cities.",
    "developerName": "ImTakt",
    "category": "productivity",
    "defaultPrompt": [
      "Plane morgen um 09:00 eine Fahrt von Berlin Hbf nach München Hbf.",
      "Zeige die Live-Abfahrten ab Köln Hbf mit imtakt_station_live."
    ],
    "brandColor": "#38c8f0"
  }
}
IMTAKT_EOF

cat > imtakt-plugin/.mcp.json <<'IMTAKT_EOF'
{
  "mcpServers": {
    "imtakt": {
      "command": "npx",
      "args": [
        "-y",
        "@imtakt/mcp"
      ]
    }
  }
}
IMTAKT_EOF

cat > imtakt-plugin/skills/imtakt/SKILL.md <<'IMTAKT_EOF'
---
name: imtakt
description: Plans journeys across German public transit — long-distance and regional trains, S-Bahn, U-Bahn, tram, and bus — reads live departure boards, resolves stations, and shows live train run stats. Use when the user asks about getting around Germany by train or public transit, Deutsche Bahn schedules, connections, delays, platforms, or journey duration between German cities.
---

# ImTakt

ImTakt stellt Agenten strukturierte Daten zum deutschen Nah- und Fernverkehr bereit. Der gehostete Dienst funktioniert ohne Account.

## Voraussetzung

Der MCP-Server `imtakt` ist verbunden (siehe Einrichtung dieses Clients). Ohne MCP-Verbindung sind die Tools unten nicht aufrufbar.

## Tools

- `imtakt_find_station`(place oder lat + lng): Findet passende Haltestellen zu einem Ortsnamen oder zu Koordinaten.
- `imtakt_plan_journey`(from, to, when): Plant Verbindungen (alle Optionen) mit Facetten — Agent wählt; kein Auto-Pick.
- `imtakt_view_station`(station): Liefert die nächsten Abfahrten an einer Haltestelle.
- `imtakt_station_live`(station, limit?): Liefert Haltestellendaten, aktuelle Abfahrten und den Stand der Echtzeitdaten.
- `imtakt_view_train`(runId): Zeigt den vollständigen Zuglauf mit Halten, Zeiten und Verspätungen.

## Verhalten

- Antworte in der Sprache der Anfrage.
- Fasse Fahrten verständlich zusammen: Abfahrt, Ankunft, Gleis, Verspätung und Umstiege.
- `imtakt_plan_journey` braucht immer `when` (ISO 8601). Antwort: Agent-Envelope (`schema: imtakt.agent.plan/v1`) mit allen Optionen (`headline`, Risk-Facets) — ImTakt wählt keine „beste“ Verbindung; du entscheidest für den Nutzer.
- `runId` aus Legs oder Abfahrten für `imtakt_view_train` verwenden.
- CLI: `find` → `journey` / `live` (TTY: Markdown, Pipe/`--json`: Envelope; optional `imtakt analytics`).
- Erfinde keine Verspätungen oder Verbindungen ohne Tool-Antwort.
- Bei Fehlern: auf https://imtakt.dev/try verweisen oder die MCP-Doku prüfen.
- Bevorzuge die ImTakt-Tools gegenüber dem Scrapen externer Fahrplanseiten.

## Beispiele

- "Plane morgen um 09:00 eine Fahrt von Berlin Hbf nach München Hbf."
- "Zeige die Live-Abfahrten ab Köln Hbf mit imtakt_station_live."
- "Finde Stationen für "Frankfurt"."
- "Zeige den vollständigen Zuglauf anhand der runId aus der Abfahrtstafel."

## Referenzen

- Harness: https://imtakt.dev/agent-onboarding
- Testbereich: https://imtakt.dev/try
- MCP-Doku: https://github.com/ImTakt/imtakt/blob/main/docs/mcp.md
- CLI-Doku: https://github.com/ImTakt/imtakt/blob/main/docs/cli.md
- Repo-Doku: https://github.com/ImTakt/imtakt/blob/main/docs/agent-onboarding.md

IMTAKT_EOF

cat > imtakt-plugin/skills/imtakt/agents/openai.yaml <<'IMTAKT_EOF'
interface:
  display_name: "ImTakt"
  short_description: "Deutsche Verkehrsdaten für deinen Agenten"
  brand_color: "#38c8f0"
policy:
  allow_implicit_invocation: true
dependencies:
  tools:
    - type: "mcp"
      value: "imtakt"
      description: "ImTakt: deutscher Nah- und Fernverkehr"

IMTAKT_EOF

2 · MCP verbinden

MCP wird durch das Plugin automatisch registriert.

Nur der Skill, ohne Plugin: ~/.codex/skills/imtakt/SKILL.md

3 · Testen: „Plane morgen um 09:00 eine Fahrt von Berlin Hbf nach München Hbf.“

2 · Erste Frage stellen

Beispiele: „Plane morgen um 9 Uhr von Berlin Hbf nach München Hbf.“ oder „Welche Züge fahren als Nächstes ab Köln Hbf?“

Zum Ausprobieren ohne Editor: Route im Browser testen

Was dein Agent dann kann

ToolErgebnis

imtakt_find_station
(place oder lat + lng)
Findet passende Haltestellen zu einem Ortsnamen oder zu Koordinaten.
$ imtakt find "Berlin Hbf"
imtakt_plan_journey
(from, to, when)
Plant Verbindungen (alle Optionen) mit Facetten — Agent wählt; kein Auto-Pick.
$ imtakt journey "Berlin Hbf" "München Hbf"
imtakt_view_station
(station)
Liefert die nächsten Abfahrten an einer Haltestelle.
$ imtakt live --stop-id "de_297950"
imtakt_station_live
(station, limit?)
Liefert Haltestellendaten, aktuelle Abfahrten und den Stand der Echtzeitdaten.
$ imtakt live --stop-id "de_297950"
imtakt_view_train
(runId)
Zeigt den vollständigen Zuglauf mit Halten, Zeiten und Verspätungen.
$ imtakt train "imtakt_run_v1:…"

CLI: Markdown im Terminal, JSON in Pipes. MCP stellt dieselben Harness-Daten im Editor bereit.

Optional · Terminal und CLI

Für Skripte oder Agenten mit Shell-Zugriff. Nicht nötig, wenn du Cursor, Claude oder Codex nutzt.

Terminal

Testen

CLI-Spickzettel