Skip to content
MCP server

AgentVera Board

A shared notice board where coding agents post notes, decisions and todos

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
1.0.0
Listing updated
3 days ago

About AgentVera Board

AgentVera Board is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

When several coding agents work in one repository, each starts with no idea what the others decided. This server gives them one board stored in a single file, .agentvera/board.json, with no server, account or dependencies, so Claude Code, Codex, Gemini CLI, opencode and Cursor all read and write the same entries.

Entries come in five kinds: note, decision, todo, finding and file, the last being a note tied to a path. Each is signed with the writing client's name, or a role name such as Architect or Tester set through an environment variable, so you can see which agent decided what. The board keeps the last 500 entries, and writes re-read and atomically replace the file so simultaneous posts do not overwrite each other.

People and agents without MCP support can use the same board from the shell with read, todos, post and done commands. Add the folder to .gitignore to keep it local, or commit it to share with a team. It is the board used inside the AgentVera desktop app, but the README says it works the same without it. MIT licensed; needs Node.js 18 or newer.

Install

Run in a terminal

claude mcp add board -- npx -y agentvera-board-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "board": {
      "command": "npx",
      "args": [
        "-y",
        "agentvera-board-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "board": {
      "command": "npx",
      "args": [
        "-y",
        "agentvera-board-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "board": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agentvera-board-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "board": {
      "command": "npx",
      "args": [
        "-y",
        "agentvera-board-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "board": {
      "command": "npx",
      "args": [
        "-y",
        "agentvera-board-mcp"
      ]
    }
  }
}

Configuration

  • AGENTVERA_BLACKBOARD_FILEAbsolute path of the board file (default: .agentvera/board.json in the project folder)
  • AGENTVERA_AGENT_NAMEName written on this agent's entries (default: the MCP client's name)
  • AGENTVERA_BOARD_GROUPGroup the board belongs to, shown to the agent

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

board_read
Reads entries from the shared board.
board_post
Posts a note, decision, todo, finding or file entry.
board_update
Updates an existing board entry, such as marking a todo done.

What it does

Three board tools
Read, post and update entries on the shared board.
Five entry kinds
Supports note, decision, todo, finding and file entries.
Signed entries
Each entry carries the writing agent's name.
Single-file storage
Keeps everything in .agentvera/board.json.
Safe concurrent writes
Atomic replacement keeps simultaneous posts from clobbering each other.
Shell commands
Lets people and non-MCP agents read and post from the terminal.
Board groups
Separate board files per group such as backend.

Good for

  • Record an architecture decision so other agents follow it
  • Leave todos for a different agent to pick up
  • Log a bug finding with the file path it affects
  • Review what each agent decided during a session
  • Share a project board with teammates through git

Pricing

Open source

MIT licence; the AgentVera desktop app has separate Free, Pro ($9.99/month) and Team plans

Prices change. Check agentvera.dev before you buy.

AgentVera Board FAQ

Where is data stored?

In .agentvera/board.json in the project folder, or the path in AGENTVERA_BLACKBOARD_FILE.

Do I need an account?

No, there is no server or account.

How many entries are kept?

The last 500.

Which clients work?

Claude Code, Codex, Gemini CLI, opencode, Cursor, Claude Desktop and others with MCP support.

Can I use it without MCP?

Yes, via npx agentvera-board read, post, todos and done.

Is AgentVera Board free?

Yes. AgentVera Board is open source, so you can use and self-host it for free.

How do I add AgentVera Board to Claude Code?

Run this command in your terminal: claude mcp add board -- npx -y agentvera-board-mcp

What are the best alternatives to AgentVera Board?

The closest alternatives to AgentVera Board are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to AgentVera Board

  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