Skip to content
MCP server

StateDock

Shared project memory so coding agents pick up each other's tasks and handoffs

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://statedock.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "statedock": {
      "url": "https://statedock.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools