timepoint-mcp

MCP server for the Timepoint AI temporal knowledge platform.

Domain: mcp.timepointai.com

What is this?

An MCP (Model Context Protocol) server that gives AI agents structured access to the Timepoint ecosystem:

• Search & browse a causal graph of 196+ historical moments spanning 2000+ years

• Generate timepoints — rich historical scenes with narratives, characters, dialog, and AI images

• Navigate time — step forward/backward from any moment to discover what came before and after

• Chat with historical characters — in-context conversations with period-appropriate personalities

• Run simulations — multi-entity temporal scenarios via the SNAG engine

Works with Claude Desktop, Cursor, Windsurf, VS Code Copilot, the Anthropic Agent SDK, and any MCP-compatible client.

Quick start

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor / Windsurf

Add to .cursor/mcp.json or equivalent:

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

Local development (stdio)

git clone https://github.com/timepointai/timepoint-mcp.git
cd timepoint-mcp
pip install -e .
python -m app.server --transport stdio

Tools

Free tier (no credits required)

Generation tier (credits required)

Simulation tier (credits required)

Pricing

Credit packs also available as one-time purchases.

Anonymous access (no API key) is available for read-only clockchain tools at 30 req/min.

Architecture

MCP Clients (Claude, Cursor, agents)
        │
        │ Streamable HTTP + API key
        ▼
   timepoint-mcp
   mcp.timepointai.com
        │
   ┌────┼────┬────────┐
   ▼    ▼    ▼        ▼
 Clock  Flash Billing  Pro
 chain        (Stripe) (SNAG)

The MCP server is a thin coordination layer. It authenticates requests, resolves user tiers via Billing, checks credit balance via Flash, routes tool calls to the appropriate backend service, and enforces rate limits.

Development

# Install dependencies
pip install -e ".[dev]"

# Run locally with stdio transport
python -m app.server --transport stdio

# Run locally with HTTP transport
python -m app.server --transport http --port 8000

# Run tests
pytest

Environment variables

FLASH_URL=https://api.timepointai.com
FLASH_SERVICE_KEY=...
FLASH_ADMIN_KEY=...
CLOCKCHAIN_URL=...
CLOCKCHAIN_SERVICE_KEY=...
BILLING_URL=...
BILLING_SERVICE_KEY=...
DATABASE_URL=postgresql://...

License

Proprietary. Copyright 2026 Timepoint AI.