Cratis Chronicle MCP Server
by cratisio.github.Cratis/chronicle-mcpv2.0.0
Inspect Cratis Chronicle event stores read-only by default; opt-in, authorized job control.
context tax
pending
security
pending
cold start
pending
freshness
pending
Our reading of Cratis Chronicle, from the data
Cratis Chronicle is an MCP server from cratis, listed in the official MCP Registry.
We haven't measured its tool list yet, so its token cost is unknown.
It runs locally on your machine over stdio and needs 2 secrets (Cratis__Chronicle__Mcp__ClientSecret, Cratis__Chronicle__Mcp__ApiKey); use a scoped, least-privilege key.
Install Cratis Chronicle MCP server
Install in Claude Code
claude mcp add chronicle-cratis -e Cratis__Chronicle__Mcp__ClientSecret='<cratis--chronicle--mcp--clientsecret>' -e Cratis__Chronicle__Mcp__ApiKey='<cratis--chronicle--mcp--apikey>' -- docker run -i --rm -e Cratis__Chronicle__Mcp__ClientSecret -e Cratis__Chronicle__Mcp__ApiKey docker.io/cratis/chronicle-mcp:2.0.0Install in Cursor
{
"mcpServers": {
"chronicle-cratis": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"Cratis__Chronicle__Mcp__ClientSecret",
"-e",
"Cratis__Chronicle__Mcp__ApiKey",
"docker.io/cratis/chronicle-mcp:2.0.0"
],
"env": {
"Cratis__Chronicle__Mcp__ClientSecret": "<cratis--chronicle--mcp--clientsecret>",
"Cratis__Chronicle__Mcp__ApiKey": "<cratis--chronicle--mcp--apikey>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"chronicle-cratis": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"Cratis__Chronicle__Mcp__ClientSecret",
"-e",
"Cratis__Chronicle__Mcp__ApiKey",
"docker.io/cratis/chronicle-mcp:2.0.0"
],
"env": {
"Cratis__Chronicle__Mcp__ClientSecret": "<cratis--chronicle--mcp--clientsecret>",
"Cratis__Chronicle__Mcp__ApiKey": "<cratis--chronicle--mcp--apikey>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"chronicle-cratis": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"Cratis__Chronicle__Mcp__ClientSecret",
"-e",
"Cratis__Chronicle__Mcp__ApiKey",
"docker.io/cratis/chronicle-mcp:2.0.0"
],
"env": {
"Cratis__Chronicle__Mcp__ClientSecret": "<cratis--chronicle--mcp--clientsecret>",
"Cratis__Chronicle__Mcp__ApiKey": "<cratis--chronicle--mcp--apikey>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"chronicle-cratis": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"Cratis__Chronicle__Mcp__ClientSecret",
"-e",
"Cratis__Chronicle__Mcp__ApiKey",
"docker.io/cratis/chronicle-mcp:2.0.0"
],
"env": {
"Cratis__Chronicle__Mcp__ClientSecret": "<cratis--chronicle--mcp--clientsecret>",
"Cratis__Chronicle__Mcp__ApiKey": "<cratis--chronicle--mcp--apikey>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| Cratis__Chronicle__Mcp__Profile | — | — | Deployment profile. ReadOnly (default) registers inspection tools only. Mutation also needs an Authorization policy: https://www.cratis.io/chronicle-mcp/deployment-profiles/ |
| Cratis__Chronicle__Mcp__ConnectionString | — | — | Chronicle endpoint reachable from the container; host.docker.internal reaches the host on macOS/Windows. |
| Cratis__Chronicle__Mcp__ClientId | — | — | OAuth client ID; set together with ClientSecret to override development credentials. |
| Cratis__Chronicle__Mcp__ClientSecret | — | yes | OAuth client secret; set together with ClientId to override development credentials. |
| Cratis__Chronicle__Mcp__ApiKey | — | yes | API key for authentication, as an alternative to client credentials. |
| Cratis__Chronicle__Mcp__EventStore | — | — | Default event store used by tools when none is specified. |
| Cratis__Chronicle__Mcp__Namespace | — | — | Default namespace used by tools when none is specified. |
Freshness
Not enough public signals yet to judge maintenance.
Last commit (default branch)
2026-10-18 · today · GitHub
Latest release
2026-10-09 · 9d ago · GitHub · v2.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-09 · 9d ago · official registry · v2.0.0
FAQ
›How do I install the Cratis Chronicle MCP server in Claude Code?
Run: claude mcp add chronicle-cratis -e Cratis__Chronicle__Mcp__ClientSecret='<cratis--chronicle--mcp--clientsecret>' -e Cratis__Chronicle__Mcp__ApiKey='<cratis--chronicle--mcp--apikey>' -- docker run -i --rm -e Cratis__Chronicle__Mcp__ClientSecret -e Cratis__Chronicle__Mcp__ApiKey docker.io/cratis/chronicle-mcp:2.0.0. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Cratis Chronicle require an API key?
Yes. It expects Cratis__Chronicle__Mcp__ClientSecret, Cratis__Chronicle__Mcp__ApiKey, of which 2 are secrets.
›Can I use Cratis Chronicle as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Cratis Chronicle in the official MCP registry?
Yes, as io.github.Cratis/chronicle-mcp.
Sources and method
- Official MCP Registry entry
- updated 2026-10-09
- GitHub repository
- fetched 2026-10-19
- Package registry (npm / PyPI)
- listed
- Last checked against all sources
- 2026-10-19
The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.