
StateDock
dev.statedockPublished by statedock.devOfficial publisherv0.1.0Updated Oct 27, 2026
Shared task layer for AI agents: tasks, handoffs and decisions that persist across tools.
Overview
Remote MCP server giving AI coding agents a shared project memory of goals, decisions and handoffs that persist across tools.
- What you can do
- Read shared project context such as goals and decisions over MCP
- Pick up ready work items and record progress
- Write back handoffs so the next agent or session can resume
- Keep task state consistent across Claude Code, Cursor, Codex and similar tools
- Companion plugins add skills for saving plans and restoring task context
- When to use it
- Useful when several coding agents or sessions work on the same project and you want decisions, plans and handoffs to carry over instead of each agent starting from zero.
- Requirements
- A remote endpoint at statedock.dev reached over streamable HTTP, with OAuth sign-in required. No environment variables or headers are declared. The README also describes a self-hosted Cloudflare edition that requires your own Cloudflare resources, a verified email sender, a public HTTPS origin, secrets and administrator approval.
Installation
In SourceWeft
- Open StateDock in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/dev.statedock%2Fstatedock/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"statedock": {
"type": "http",
"url": "https://statedock.dev/mcp"
}
}
}README
StateDock
Shared project memory for you and your coding agents.
Goals, decisions and handoffs live in one place. Claude Code, Cursor and Codex read context over MCP, pick up ready work and write back handoffs, so the next agent never starts from zero.
This repository is the Cloudflare self-hosted edition. Deploy it in your own Cloudflare account; you operate its Workers, D1, KV, R2, domain, email delivery, and backups. It is separate from StateDock Cloud and has no Cloud subscription tiers. To run StateDock on your own computer or a Linux server with one command, use StateDock Local instead.
- Product and shared feature guide: statedock.dev/doc
- Install and deploy: docs/self-hosting.md
- Back up, restore, and upgrade: docs/operations.md
- Agent and MCP setup: docs/agent-setup.md
- Architecture, validation, and migrations: docs/architecture.md · docs/validation.md · docs/migrations.md
- Security reports: SECURITY.md
Coding-tool plugins
StateDock's separate MIT plugin repository provides shared Skills for saving plans, restoring task context, and recording progress through StateDock Remote MCP. The current packages target the hosted service at https://statedock.dev/mcp; self-hosted deployments can use the Skills with their own MCP setup, but the published packages' default endpoint is the hosted service.
- Codex: available from the plugin repository's local marketplace; installation is documented in its README.
- DeepSeek Harness:
@statedock/dsh-pluginis published for Harness0.2.0-rc.2; see the official community showcase. - ChatGPT app: submitted to OpenAI for review; approval is pending.
- Cursor: Marketplace submission materials are being prepared; installation and approval are not yet verified.
These plugins record and restore project state. They do not execute task code or schedule agents. Plugin code is MIT-licensed; this self-hosted service remains AGPL-3.0-only.
For a complete local install, use the deployment guide above. It covers the required Cloudflare resources, verified email sender, public HTTPS origin, secrets, migrations, deployment, administrator approval, and agent access. The operations guide contains offline backup and recovery steps.
Development checks
Requirements and the repository's checks are listed in CONTRIBUTING.md. Typical verification:
License
StateDock is licensed under AGPL-3.0-only. Dependencies retain their own licenses; see THIRD_PARTY_NOTICES.md. The license does not grant rights to StateDock trademarks or imply official endorsement of third-party instances.
Source: README.md at commit 3b7a7e8
Tools
0Version history
1- v0.1.0LatestOct 16, 2026
Score
85% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts