timepoint-mcp

Name: Timepoint MCP
Author: timepointai

Servidor MCP para la plataforma de conocimiento temporal Timepoint AI.

En vivo en: mcp.timepointai.com

¿Qué es esto?

Un servidor Model Context Protocol alojado que brinda a los agentes de IA acceso estructurado al ecosistema Timepoint:

Buscar y navegar por un grafo causal de más de 3.900 momentos históricos y más de 5 millones de aristas que abarcan desde el 700 a. C. hasta 2026
Generar puntos temporales — escenas históricas enriquecidas con narrativas, personajes, diálogos e imágenes generadas por IA (Fase 2 — en desarrollo)
Navegar por el tiempo — avanzar/retroceder desde cualquier momento para descubrir qué ocurrió antes y después (Fase 2 — en desarrollo)
Chatear con personajes históricos — conversaciones contextuales con personalidades apropiadas para la época (Fase 2 — en desarrollo)
Ejecutar simulaciones — escenarios temporales multi-entidad a través del motor SNAG (Fase 3 — planificado)

Funciona con Claude Desktop, Cursor, Windsurf, VS Code Copilot, el SDK de Anthropic Agent y cualquier cliente compatible con MCP.

Obtener una clave API

Visita timepointai.com o contáctanos en X @timepointai para solicitar acceso.

Las herramientas de lectura de Clockchain (búsqueda, navegación, detalle de momentos) funcionan sin autenticación a 30 peticiones/min. Las herramientas de generación y simulación requieren una clave API y créditos.

Inicio rápido

Claude Desktop

Añade a tu claude_desktop_config.json:

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

Cursor / Windsurf

Añade a .cursor/mcp.json o equivalente:

{
  "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?")

Desarrollo local

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

Herramientas disponibles

Fase 1 (disponible ahora) — Herramientas de lectura de Clockchain

Herramienta	Autenticación	Descripción
`search_moments`	Opcional	Busca eventos históricos en el grafo causal temporal
`get_moment`	Opcional	Obtiene el detalle completo de un momento histórico por su ruta canónica
`browse_graph`	Opcional	Navega por la jerarquía del grafo: año, mes, día, ubicación, evento
`get_connections`	Opcional	Obtiene conexiones causales/temáticas: qué causó esto, qué provocó
`today_in_history`	Clave	Eventos que ocurrieron en la fecha de hoy a través de todas las eras
`random_moment`	Clave	Momento histórico aleatorio para descubrimientos fortuitos
`graph_stats`	Opcional	Recuento de nodos/aristas, rango de fechas, distribución de fuentes

Fase 2 (próximamente) — Herramientas de generación

Herramienta	Créditos	Descripción
`generate_timepoint`	5-10	Genera un punto temporal histórico con escena, personajes, diálogo, imagen
`temporal_navigate`	2	Avanza/retrocede en el tiempo desde un punto temporal existente
`chat_with_character`	1	Conversa con un personaje histórico en contexto
`get_timepoint`	0	Recupera un punto temporal generado previamente
`list_my_timepoints`	0	Lista tus puntos temporales generados
`get_credit_balance`	0	Comprueba créditos y uso

Fase 3 (planificado) — Herramientas de simulación

Herramienta	Créditos	Descripción
`run_simulation`	10	Ejecuta una simulación temporal SNAG
`get_simulation_result`	0	Obtiene resultados de la simulación

Precios

Nivel	Precio	Créditos mensuales	Límite de tasa
Anónimo	Gratis	—	30 pet/min (solo lectura)
Gratis	Gratis	5 créditos de registro	60 pet/min
Explorer	$7.99/mes	100	60 pet/min
Creator	$19.99/mes	300	300 pet/min
Studio	$49.99/mes	1.000	1.000 pet/min

Paquetes de créditos también disponibles como compras únicas.

Endpoints HTTP

Además del protocolo MCP en /mcp, el servidor expone:

Método	Ruta	Descripción
GET	`/`	Página de inicio (JSON para agentes, redirección para navegadores)
GET	`/health`	Comprobación de estado del servicio
GET	`/account/status`	Estado de autenticación e información de nivel
POST	`/admin/create-key`	Crear clave API (requiere clave de administrador)

Arquitectura

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)

El servidor MCP es una capa de coordinación ligera. Autentica solicitudes mediante claves API, resuelve los niveles de usuario a través de Billing, verifica el saldo de créditos a través del Gateway, enruta las llamadas a herramientas al backend apropiado y aplica límites de tasa por nivel. Nunca almacena créditos ni suscripciones: el Gateway y Billing son los responsables de ello.

Stack tecnológico

Python 3.11+ con FastMCP, Starlette, httpx, asyncpg
Transporte: HTTP transmitible (producción), stdio (desarrollo local)
Base de datos: PostgreSQL (claves API + registros de uso)
Despliegue: Railway (Docker)

Variables de entorno

# 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

Representa el pasado. Simula el futuro. Puntúa las predicciones. Acumula el grafo.

Servicio	Tipo	Repositorio	Rol
API Gateway	Privado	timepoint-api-gateway	Autoridad de autenticación — JWT, OAuth (Apple/Google/GitHub), créditos, límite de tasa en api.timepointai.com
Flash	Código abierto	timepoint-flash	Escritor de realidad — motor de generación pura (sin autenticación), renderiza momentos históricos fundamentados
Clockchain	Código abierto	timepoint-clockchain	Grafo causal temporal — 3.900+ nodos, 5M+ aristas, endpoint MCP, creciendo 24/7
Pro	Código abierto	timepoint-pro	Motor de simulación SNAG — simulación temporal, salida TDF, datos de entrenamiento
Proteus	Código abierto	proteus	Capa de liquidación — mercados de predicción para futuros renderizados
TDF	Código abierto	timepoint-tdf	Formato de datos — intercambio JSON-LD entre todos los servicios
SNAG Bench	Código abierto	timepoint-snag-bench	Certificador de calidad — mide la resolución causal en las representaciones
Billing	Privado	timepoint-billing	Procesamiento de pagos — Apple IAP + Stripe
MCP	Público	timepoint-mcp	Servidor MCP — acceso de agentes de IA a Flash y Clockchain
Web App	Privado	timepoint-web-app	Cliente de navegador en app.timepointai.com
Landing	Privado	timepoint-landing	Sitio de marketing en timepointai.com
iPhone App	Privado	timepoint-iphone-app	Cliente iOS — Viaje en el tiempo sintético en móvil
Skip Meetings	Privado	skipmeetingsai	SaaS de inteligencia de reuniones impulsado por Flash

Timepoint MCP