# StateLode

> StateLode is a freemium MCP server for developer tools. A shared task board your coding agents read and write so sessions can hand off work. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $10 a month
- **Platforms:** CLI, Web
- **Website:** https://statelode.dev
- **Repository:** https://github.com/statelode/statelode-bridge
- **MCP Registry name:** dev.statelode/statelode
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

A session's context vanishes when it ends. StateLode keeps the hand-off on a board instead: an agent claims a task, leaves notes on what it did and did not finish, and the next session, from Claude Code, Cursor or Codex, resumes from those notes.

The whole protocol is three tools. Writes carry the task's updatedAt value, so a stale write returns a STALE_WRITE error with the current state for the agent to retry against. A review gate means agents move finished work to review rather than done, only done unblocks dependent tasks, and every move is logged with the agent that made it.

Remote clients connect over hosted HTTP with sign-in, while an open-source stdio bridge, statelode-bridge, serves older clients and can write StateLode rules into agent instruction files such as CLAUDE.md and AGENTS.md. A statelode.json file pins a repo to a project.

## Features

- **Three-tool protocol:** task_search, task_get and task_mutate cover reading and changing every task.
- **Stale-write protection:** Updates carry updatedAt and conflicts return the current task state.
- **Review gate:** Agents move work to review; only done unblocks waiting tasks.
- **Activity log:** Every move is recorded with the agent that made it.
- **Stdio bridge:** statelode-bridge connects stdio-only clients to the hosted endpoint.
- **Instruction setup:** Setup and init commands write StateLode rules into each agent's guide files.

## Good for

- Let a new session continue what the last one left unfinished
- Run several agents on one project without duplicate work
- Require a review step before dependent tasks unlock
- Pin a repository to a task project

## Install

### Claude Code (Terminal)

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

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

```sh
https://api.statelode.dev/mcp
```

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

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

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

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

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

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

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

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

## Tools

- `task_search`: Searches tasks on the board.
- `task_get`: Reads one task.
- `task_mutate`: Creates, moves and updates tasks with stale-write protection.

## FAQ

### Which clients work?

Cursor, Claude Code, Codex, Windsurf and Antigravity connect over remote HTTP; stdio clients use the bridge.

### What does it cost?

Free for a solo workspace, Pro $10/mo, Team $12/user/mo, Enterprise custom.

### How do I authenticate the bridge?

Set a StateLode workspace token in STATELODE_TOKEN.

### Where do the rules go?

The setup command adds a delimited block to global instruction files and never overwrites your existing rules.

### Is StateLode free?

StateLode has a free plan, with paid plans for more usage or features. Paid plans start at $10 a month.

### How do I add StateLode to Claude Code?

Run this command in your terminal: claude mcp add --transport http statelode https://api.statelode.dev/mcp

### What are the best alternatives to StateLode?

The closest alternatives to StateLode 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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.

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