Pursers MCP Server
by swisspraio.github.swisspra/pursersv5.2.1
Coordinate AI-agent work on a local-first, owner-controlled MCP board
context tax
queued
security
queued
cold start
queued
freshness
Active5d ago
Install Pursers MCP server
Install in Claude Code
claude mcp add pursers-central -- uvx pursers-client pursers-mcp --central-url '<central-url>' --board '<board-id>' --token-file '<token-file>' --tools defaultInstall in Cursor
{
"mcpServers": {
"pursers-central": {
"command": "uvx",
"args": [
"pursers-client",
"pursers-mcp",
"--central-url",
"<central-url>",
"--board",
"<board-id>",
"--token-file",
"<token-file>",
"--tools",
"default"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"pursers-central": {
"command": "uvx",
"args": [
"pursers-client",
"pursers-mcp",
"--central-url",
"<central-url>",
"--board",
"<board-id>",
"--token-file",
"<token-file>",
"--tools",
"default"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"pursers-central": {
"type": "stdio",
"command": "uvx",
"args": [
"pursers-client",
"pursers-mcp",
"--central-url",
"<central-url>",
"--board",
"<board-id>",
"--token-file",
"<token-file>",
"--tools",
"default"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"pursers-central": {
"command": "uvx",
"args": [
"pursers-client",
"pursers-mcp",
"--central-url",
"<central-url>",
"--board",
"<board-id>",
"--token-file",
"<token-file>",
"--tools",
"default"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ONBOARD_CENTRAL_HOST | — | — | Loopback bind host used by the packaged runtime |
| ONBOARD_CENTRAL_PORT | — | — | Loopback bind port used by the packaged runtime |
| ONBOARD_CENTRAL_DATA_DIR | — | — | Private Central data directory; --data-dir/--data-root is the equivalent CLI input |
| ONBOARD_CENTRAL_LOG_LEVEL | — | — | Packaged runtime log level |
| ONBOARD_CENTRAL_ALLOWED_HOSTS | — | — | Optional comma-separated bare Host names accepted in addition to the bind host |
| ONBOARD_CENTRAL_TLS_CERTFILE | — | — | Optional TLS certificate path; requires ONBOARD_CENTRAL_TLS_KEYFILE |
| ONBOARD_CENTRAL_TLS_KEYFILE | — | yes | Optional TLS private-key path; requires ONBOARD_CENTRAL_TLS_CERTFILE |
| CENTRAL_ADMISSION | — | — | Central admission policy; Pursers supports invite-only admission |
| CENTRAL_AUTH_MODE | — | — | Central authentication mode; Pursers supports JWT authentication |
| CENTRAL_JWKS_PATH | yes | — | Path to the issuer public JWKS used to verify seat credentials |
| CENTRAL_JWT_AUDIENCE | — | — | MCP resource URL in audience and resource claims; defaults to the loopback bind URL |
| CENTRAL_JWT_CLOCK_SKEW | — | — | Allowed JWT clock skew in seconds |
| CENTRAL_JWT_ISSUER | yes | — | Exact issuer URL in every accepted seat credential |
| CENTRAL_PRINCIPAL_STREAM_CAP | — | — | Maximum concurrent event streams accepted per principal |
| CENTRAL_REAPER_INTERVAL_S | — | — | Interval in seconds between expired-lease reaper sweeps |
| CENTRAL_REQUEST_STATE_KEY_FILE | — | yes | Optional restart-safe request-state keyring path |
| PURSERS_LEGACY_TOOLS | — | — | String flag: use 1 to expose deprecated coordination tools; use 0 to keep them hidden |
| STORE_BACKEND | — | — | Central storage backend; Pursers supports SQLite |
Freshness
Active — last maintenance signal 5d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-05 · 5d ago · GitHub
Latest release
2026-10-05 · 5d ago · GitHub · v5.2.1
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 5d ago · official registry · v5.2.1
FAQ
›How do I install the Pursers MCP server in Claude Code?
Run: claude mcp add pursers-central -- uvx pursers-client pursers-mcp --central-url '<central-url>' --board '<board-id>' --token-file '<token-file>' --tools default. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Pursers require an API key?
Yes. It expects CENTRAL_JWKS_PATH, CENTRAL_JWT_ISSUER, ONBOARD_CENTRAL_TLS_KEYFILE, CENTRAL_REQUEST_STATE_KEY_FILE, of which 2 are secrets.
›Can I use Pursers as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Pursers in the official MCP registry?
Yes, as io.github.swisspra/pursers.