Skip to main content

​
MCP Server

The Clockchain exposes its temporal causal graph via the Model Context Protocol (MCP), making it accessible to any compatible AI agent framework (Claude, GPT, custom agents).

​
Status

Live — Clockchain MCP v1.26.0 is deployed at clockchain.timepointai.com/mcp/ using Streamable HTTP transport.

​
Endpoint

https://clockchain.timepointai.com/mcp/
Transport: Streamable HTTP

​
MCP Tools

ToolDescription
clockchain_statsGet graph statistics (node count, edge types, date range)
clockchain_searchSearch moments by keyword, date range, entity, location
clockchain_momentGet a specific moment by canonical path with edges
clockchain_neighborsGet causally connected moments
flash_renderRender a new historical moment (requires auth)
pro_simulateRun a social simulation (requires auth)

​
Integration Example

Connect the Clockchain MCP server to your AI agent: 
{
  "mcpServers": {
    "clockchain": {
      "url": "https://clockchain.timepointai.com/mcp/",
      "transport": "streamable-http"
    }
  }
}

​
Direct HTTP Access

Any AI agent can also query the Clockchain directly using the public REST API: 
# Get graph stats
GET /api/v1/stats

# Search moments
GET /api/v1/moments?q=rome&year_from=-500&year_to=500

# Get specific moment
GET /api/v1/moments/{canonical-path}
No authentication required. 60 requests/minute rate limit. Sign up at timepointai.com for early access to authenticated tools.