timepoint-mcp

Name: Timepoint MCP
Author: timepointai

MCP-Server für die Timepoint AI temporale Wissensplattform.

Live unter: mcp.timepointai.com

Was ist das?

Ein gehosteter Model Context Protocol Server, der KI-Agenten strukturierten Zugriff auf das Timepoint-Ökosystem bietet:

Suchen & Durchsuchen eines kausalen Graphen von über 3.900 historischen Momenten und über 5 Mio. Kanten, die den Zeitraum von 700 v. Chr. bis 2026 abdecken
Generieren von Zeitpunkten — reichhaltige historische Szenen mit Erzählungen, Charakteren, Dialogen und KI-Bildern (Phase 2 — in Entwicklung)
Navigation durch die Zeit — Vorwärts-/Rückwärtsschritte von jedem Moment aus, um zu entdecken, was davor und danach geschah (Phase 2 — in Entwicklung)
Chat mit historischen Charakteren — kontextbezogene Unterhaltungen mit zeitgemäßen Persönlichkeiten (Phase 2 — in Entwicklung)
Simulationen ausführen — temporale Szenarien mit mehreren Entitäten über die SNAG-Engine (Phase 3 — geplant)

Funktioniert mit Claude Desktop, Cursor, Windsurf, VS Code Copilot, dem Anthropic Agent SDK und jedem MCP-kompatiblen Client.

API-Schlüssel erhalten

Besuchen Sie timepointai.com oder kontaktieren Sie uns auf X @timepointai, um Zugriff anzufordern.

Clockchain-Lesetools (Suche, Durchsuchen, Moment-Details) funktionieren ohne Authentifizierung mit 30 Anfragen/Min. Generierungs- und Simulationstools erfordern einen API-Schlüssel und Credits.

Schnellstart

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "timepoint": {
      "url": "https://mcp.timepointai.com/mcp",
      "headers": {
        "X-API-Key": "tp_mcp_..."
      }
    }
  }
}

Cursor / Windsurf

Fügen Sie dies zu .cursor/mcp.json oder Äquivalent hinzu:

{
  "mcpServers": {
    "timepoint": {
      "url": "https://mcp.timepointai.com/mcp",
      "headers": {
        "X-API-Key": "tp_mcp_..."
      }
    }
  }
}

Anthropic Agent SDK

from claude_agent_sdk import Agent
from claude_agent_sdk.mcp import MCPServerRemote

agent = Agent(
    model="claude-sonnet-4-6",
    mcp_servers=[
        MCPServerRemote(
            url="https://mcp.timepointai.com/mcp",
            headers={"X-API-Key": "tp_mcp_..."},
        )
    ],
)
result = agent.run("What happened in Rome in 44 BC?")

Lokale Entwicklung

git clone https://github.com/timepointai/timepoint-mcp.git
cd timepoint-mcp
pip install -e .

# stdio transport (for Claude Desktop local)
python -m app.server --transport stdio

# HTTP transport (for remote testing)
python -m app.server --transport http --port 8000

Verfügbare Tools

Phase 1 (jetzt live) — Clockchain-Lesetools

Tool	Auth	Beschreibung
`search_moments`	Optional	Durchsuchen des temporalen kausalen Graphen nach historischen Ereignissen
`get_moment`	Optional	Abrufen vollständiger Details für einen historischen Moment über seinen kanonischen Pfad
`browse_graph`	Optional	Durchsuchen der Graphenhierarchie — Jahr, Monat, Tag, Ort, Ereignis
`get_connections`	Optional	Abrufen kausaler/thematischer Verbindungen: Was hat dies verursacht, was wurde dadurch verursacht
`today_in_history`	Schlüssel	Ereignisse, die an diesem Datum in allen Epochen stattfanden
`random_moment`	Schlüssel	Zufälliger historischer Moment für zufällige Entdeckungen
`graph_stats`	Optional	Knoten-/Kantenanzahl, Datumsbereich, Quellenverteilung

Phase 2 (bald verfügbar) — Generierungstools

Tool	Credits	Beschreibung
`generate_timepoint`	5-10	Generieren eines historischen Zeitpunkts mit Szene, Charakteren, Dialog, Bild
`temporal_navigate`	2	Vorwärts-/Rückwärtsschritt in der Zeit von einem bestehenden Zeitpunkt aus
`chat_with_character`	1	Unterhaltung mit einem historischen Charakter im Kontext
`get_timepoint`	0	Abrufen eines zuvor generierten Zeitpunkts
`list_my_timepoints`	0	Auflisten Ihrer generierten Zeitpunkte
`get_credit_balance`	0	Überprüfen von Credits und Nutzung

Phase 3 (geplant) — Simulationstools

Tool	Credits	Beschreibung
`run_simulation`	10	Ausführen einer SNAG-temporalen Simulation
`get_simulation_result`	0	Abrufen von Simulationsergebnissen

Preisgestaltung

Stufe	Preis	Monatliche Credits	Ratenlimit
Anonym	Kostenlos	—	30 Anfragen/Min (nur Lesen)
Kostenlos	Kostenlos	5 Anmelde-Credits	60 Anfragen/Min
Explorer	$7.99/Monat	100	60 Anfragen/Min
Creator	$19.99/Monat	300	300 Anfragen/Min
Studio	$49.99/Monat	1.000	1.000 Anfragen/Min

Credit-Pakete sind auch als Einmalkäufe erhältlich.

HTTP-Endpunkte

Zusätzlich zum MCP-Protokoll unter /mcp stellt der Server Folgendes bereit:

Methode	Pfad	Beschreibung
GET	`/`	Landingpage (JSON für Agenten, Weiterleitung für Browser)
GET	`/health`	Service-Gesundheitsprüfung
GET	`/account/status`	Auth-Status und Stufeninformationen
POST	`/admin/create-key`	API-Schlüssel erstellen (erfordert Admin-Schlüssel)

Architektur

MCP Clients (Claude Desktop, Cursor, agents, SDKs)
        |
        | Streamable HTTP + X-API-Key
        v
   timepoint-mcp (mcp.timepointai.com)
   FastMCP + Starlette + asyncpg
        |
   -----+------+----------+
   |           |           |
   v           v           v
 Clockchain  Flash      Billing
 (graph)    (writer)   (Stripe/IAP)

Der MCP-Server ist eine schlanke Koordinationsschicht. Er authentifiziert Anfragen über API-Schlüssel, löst Benutzerstufen über die Abrechnung auf, prüft das Credit-Guthaben über das Gateway, leitet Tool-Aufrufe an das entsprechende Backend weiter und erzwingt Ratenlimits pro Stufe. Er speichert niemals Credits oder Abonnements — das Gateway und die Abrechnung verwalten diese.

Tech-Stack

Python 3.11+ mit FastMCP, Starlette, httpx, asyncpg
Transport: Streamable HTTP (Produktion), stdio (lokale Entwicklung)
Datenbank: PostgreSQL (API-Schlüssel + Nutzungsprotokolle)
Bereitstellung: Railway (Docker)

Umgebungsvariablen

# Downstream services
FLASH_URL=https://api.timepointai.com
FLASH_OUTBOUND_KEY=...  # key sent to Flash as X-Service-Key (was FLASH_SERVICE_KEY)
FLASH_ADMIN_KEY=...
CLOCKCHAIN_URL=...
CLOCKCHAIN_SERVICE_KEY=...
BILLING_URL=...
BILLING_SERVICE_KEY=...

# Database
DATABASE_URL=postgresql://...

# Server
PORT=8000

Timepoint Suite

Die Vergangenheit rendern. Die Zukunft simulieren. Die Vorhersagen bewerten. Den Graphen akkumulieren.

Service	Typ	Repo	Rolle
API Gateway	Privat	timepoint-api-gateway	Auth-Autorität — JWT, OAuth (Apple/Google/GitHub), Credits, Ratenbegrenzung unter api.timepointai.com
Flash	Open Source	timepoint-flash	Reality Writer — reine Generierungs-Engine (keine Auth), rendert fundierte historische Momente
Clockchain	Open Source	timepoint-clockchain	Temporaler kausaler Graph — 3.900+ Knoten, 5 Mio.+ Kanten, MCP-Endpunkt, wächst 24/7
Pro	Open Source	timepoint-pro	SNAG-Simulations-Engine — temporale Simulation, TDF-Ausgabe, Trainingsdaten
Proteus	Open Source	proteus	Settlement-Schicht — Vorhersagemärkte für gerenderte Zukünfte
TDF	Open Source	timepoint-tdf	Datenformat — JSON-LD-Austausch über alle Dienste hinweg
SNAG Bench	Open Source	timepoint-snag-bench	Qualitätszertifizierer — misst die kausale Auflösung über Renderings hinweg
Billing	Privat	timepoint-billing	Zahlungsabwicklung — Apple IAP + Stripe
MCP	Öffentlich	timepoint-mcp	MCP-Server — KI-Agentenzugriff auf Flash und Clockchain
Web App	Privat	timepoint-web-app	Browser-Client unter app.timepointai.com
Landing	Privat	timepoint-landing	Marketing-Seite unter timepointai.com
iPhone App	Privat	timepoint-iphone-app	iOS-Client — Synthetische Zeitreise auf dem Mobilgerät
Skip Meetings	Privat	skipmeetingsai	Meeting-Intelligenz-SaaS, betrieben von Flash

Timepoint MCP