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

AI-generated 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.
Before you install
OAuth grants the server access to your project data, which is stored on a third-party hosted service. Agents can write handoffs and task state, so incorrect entries persist for later sessions. The self-hosted edition makes you responsible for deployment, secrets, email delivery and backups. Plugins are described as recording and restoring state only, not executing task code or scheduling agents.

Installation

In SourceWeft

  1. Open StateDock in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. 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.

Read the install guide the agent follows

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.

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-plugin is published for Harness 0.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:

sh
pnpm install --frozen-lockfilepnpm testpnpm typecheckpnpm lintpnpm format:checkpnpm selfhost:check

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

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  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