Timepoint MCP
Officialtimepoint-mcp
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.
Related MCP server: Bi-Temporal Knowledge Graph MCP Server
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 8000Herramientas disponibles
Fase 1 (disponible ahora) — Herramientas de lectura de Clockchain
Herramienta | Autenticación | Descripción |
| Opcional | Busca eventos históricos en el grafo causal temporal |
| Opcional | Obtiene el detalle completo de un momento histórico por su ruta canónica |
| Opcional | Navega por la jerarquía del grafo: año, mes, día, ubicación, evento |
| Opcional | Obtiene conexiones causales/temáticas: qué causó esto, qué provocó |
| Clave | Eventos que ocurrieron en la fecha de hoy a través de todas las eras |
| Clave | Momento histórico aleatorio para descubrimientos fortuitos |
| 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 |
| 5-10 | Genera un punto temporal histórico con escena, personajes, diálogo, imagen |
| 2 | Avanza/retrocede en el tiempo desde un punto temporal existente |
| 1 | Conversa con un personaje histórico en contexto |
| 0 | Recupera un punto temporal generado previamente |
| 0 | Lista tus puntos temporales generados |
| 0 | Comprueba créditos y uso |
Fase 3 (planificado) — Herramientas de simulación
Herramienta | Créditos | Descripción |
| 10 | Ejecuta una simulación temporal SNAG |
| 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 |
| Comprobación de estado del servicio |
GET |
| Estado de autenticación e información de nivel |
POST |
| 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=8000Timepoint 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 |
Licencia
Propietaria. Copyright 2026 Timepoint AI.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Company brain for AI agents — temporal knowledge graph search, exploration, and durable memory.
AI-verified knowledge base with trust scoring, temporal facts, and skill cards.
Bi-temporal AI memory. 56 tools, knowledge graph, semantic search. EU-hosted, free tier.
Turn grounded AI answers into trusted comparisons, plans, timelines, and decision views.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to build and query temporally-aware knowledge graphs from conversations and data. Supports adding episodes, searching entities and facts, and maintaining persistent memory across interactions.11Apache 2.0
- FlicenseNot gradedqualityNot gradedmaintenanceGives AI agents persistent memory with bi-temporal tracking, automatically extracting entities from natural language and enabling time-travel queries to understand facts as they existed at any point in history.2-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to build and query temporally-aware knowledge graphs from conversations and data, maintaining persistent memory of entities, relationships, and facts across interactions.-
- FlicenseNot gradedqualityDmaintenanceEnables querying 10,000 years of historical social-complexity data from the Seshat Global History Databank through 9 tools, allowing counterfactual analysis and comparison of polities in natural language.1-