StateDock
Shared project memory so coding agents pick up each other's tasks and handoffs
- Pricing
- Open source
- Platforms
- API, self-hosted, Web
- Runs
- Remotely
- Version
- 0.1.0
- Listing updated
- 2 days ago
About StateDock
StateDock is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
StateDock stores goals, decisions and handoffs on a task, so the next agent starts from context instead of a fresh briefing. An agent can plan in ChatGPT, build in Codex and review elsewhere while the task record travels along; resume_project reads it over MCP.
Every handoff has three parts: what changed, how it was checked and what comes next, tied to a commit. submit_handoff records the evidence but does not prove it. When an agent is blocked, pause_task turns the problem into one clear question sent to your phone through Discord, Bark, ntfy or a webhook, and Telegram on Cloud. Answering does not wake the agent; you tell it to continue.
StateDock records state and does not run your agents. It is AGPL-3.0, with a Cloudflare self-hosted edition, a separate local edition and a hosted Cloud service, and MIT plugins for Codex and DeepSeek Harness.
Install
Run in a terminal
claude mcp add --transport http statedock https://statedock.dev/mcpAdd to Settings → Connectors → Add custom connector
https://statedock.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"statedock": {
"url": "https://statedock.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"statedock": {
"type": "http",
"url": "https://statedock.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"statedock": {
"serverUrl": "https://statedock.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"statedock": {
"type": "http",
"url": "https://statedock.dev/mcp"
}
}
}Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- resume_project
- Reads project context so an agent can pick up where the last stopped
- submit_handoff
- Records what changed, how it was checked and what is next
- pause_task
- Turns a blocked task into one question sent to your phone
What it does
- Task-held context
- Goals, decisions and history stay on the task across agents and models.
- Structured handoffs
- Each records changed, checked and next, with the commit.
- Blocked-task alerts
- pause_task sends one clear question to your phone.
- Ready-work pickup
- Agents read context and pick up ready tasks over MCP.
- Self-hostable
- AGPL-3.0, deployable on your own Cloudflare account or locally.
- State only
- Records state without executing agents or code.
Good for
- Hand work from a planning chat to a coding agent
- Switch models when you hit a quota limit
- Review what an agent actually checked
- Get asked a blocking question on your phone
Pricing
Open source
AGPL-3.0 and free to start; hosted Cloud also available
Prices change. Check statedock.dev before you buy.
StateDock FAQ
Does it run my agents?
No. It records state and doesn't run your agents.
What licence is it?
AGPL-3.0-only, with MIT-licensed plugins.
Where can it run?
Hosted at statedock.dev, on your Cloudflare account, or locally via StateDock Local.
How are blocked questions delivered?
Discord, Bark, ntfy or a webhook, plus Telegram on Cloud.
Is StateDock free?
Yes. StateDock is open source, so you can use and self-host it for free.
How do I add StateDock to Claude Code?
Run this command in your terminal: claude mcp add --transport http statedock https://statedock.dev/mcp
What are the best alternatives to StateDock?
The closest alternatives to StateDock are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to StateDock

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools