# StateDock

> StateDock is an open-source MCP server for developer tools. Shared project memory so coding agents pick up each other's tasks and handoffs. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted, Web
- **Website:** https://statedock.dev
- **Repository:** https://github.com/statedock/statedock
- **MCP Registry name:** dev.statedock/statedock
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http statedock https://statedock.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://statedock.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "statedock": {
      "url": "https://statedock.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "statedock": {
      "type": "http",
      "url": "https://statedock.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "statedock": {
      "serverUrl": "https://statedock.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "statedock": {
      "type": "http",
      "url": "https://statedock.dev/mcp"
    }
  }
}
```

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/statedock
