Skip to main content

​
Prerequisites

1

Install Node.js

Ensure Node.js 18+ is installed:
node --version  # Should be v18 or higher
2

Install sudocode CLI

The MCP server requires the sudocode CLI:
npm install -g @sudocode/cli
sudocode --version
3

Initialize project

Have a sudocode project initialized:
cd your-project
sudocode init

​
Install MCP Server

Install the sudocode MCP server globally: 
npm install -g @sudocode/mcp
Verify installation: 
sudocode-mcp --help

sudocode MCP Server

Usage: sudocode-mcp [options]

Options:
  -w, --working-dir <path>  Working directory (default: cwd or SUDOCODE_WORKING_DIR)
  --cli-path <path>         Path to sudocode CLI (default: 'sudocode' or SUDOCODE_PATH)
  --db-path <path>          Database path (default: auto-discover or SUDOCODE_DB)
  --no-sync                 Skip initial sync on startup (default: sync enabled)
  -h, --help                Show this help message

Environment Variables:
  SUDOCODE_WORKING_DIR      Default working directory
  SUDOCODE_PATH             Default CLI path
  SUDOCODE_DB               Default database path

​
Configure Your Agent

To use the MCP server with your AI agent, you’ll need to configure it in your agent’s settings. See the Agent Setup guide for detailed instructions for:
  • Claude
  • Codex
  • Cursor CLI
  • Github Copilot CLI
  • Other MCP-compatible agents

​
Verify Setup

Test that MCP tools are available: 
You: Create me a "Hello World" issue

Claude: I'll create a "Hello World" issue for you.
[Uses mcp__plugin_sudocode_sudocode__upsert_issue]

Done! I've created issue ISSUE-001: "Hello World"
If you see tool calls like mcp__plugin_sudocode_sudocode__*, the setup is working!

​
Next Steps

1

Configure your agent

Follow the Agent Setup guide for your specific AI agent
2

Review the tools

Study the MCP tools reference
3

Build workflows

Explore agent workflow examples to see practical patterns
For more details, see the MCP Server Overview.