MCP Server

The Cartesi MCP server is a read-only knowledge service your AI assistant connects to for Cartesi-specific context. Instead of guessing CLI flags or hallucinating APIs, your assistant can query curated documentation routes, repositories, articles, and skills. Many of the resources are returned inline without fetching external URLs.

The server runs at https://server.mcp.mugen.builders/mcp. No API key or local install is required; add the URL to your MCP client and connect.

Once connected, your assistant can:

• Look up CLI commands matched to the Cartesi CLI version you have installed
• Pull step-by-step skills for local dev bootstrapping, frontend and backend development, asset deposits, L1 contract interactions, and on-chain deployment
• Search documentation routes, repositories, and articles by topic for deeper context
• Prepare workflow commands (cartesi create, cartesi build, cartesi run, deposits, and inputs) as instructions to run on your machine; the MCP server does not execute the CLI for you

Connect your client

Cursor

1. Open Settings.
2. In the sidebar, click Tools and MCPs, then select New MCP Server.
3. Cursor opens your MCP config file (~/.cursor/mcp.json globally, or .cursor/mcp.json in your project). Add:

{
  "mcpServers": {
    "cartesi-mcp": {
      "transport": "http",
      "url": "https://server.mcp.mugen.builders/mcp"
    }
  }
}

4. Restart Cursor, then verify under Settings → Tools and MCPs that cartesi-mcp is connected.

Claude Code

1. Install the Claude CLI, then add the server:

claude mcp add --transport http cartesi https://server.mcp.mugen.builders/mcp

2. Restart Claude Code (or start a new conversation).
3. Run /mcp and confirm cartesi appears in the list of active MCP servers.

Codex

1. Add the server:

codex mcp add cartesi-mcp --url https://server.mcp.mugen.builders/mcp

2. Verify it was added:

codex mcp list

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "cartesi-mcp": {
      "type": "streamable-http",
      "url": "https://server.mcp.mugen.builders/mcp"
    }
  }
}

Restart Claude Desktop after saving.

VS Code Copilot

Add to .vscode/mcp.json in your project:

{
  "servers": {
    "cartesi-mcp": {
      "type": "http",
      "url": "https://server.mcp.mugen.builders/mcp"
    }
  }
}

Restart VS Code after saving. Requires GitHub Copilot with MCP support enabled.

For any other MCP-compatible client, point it at https://server.mcp.mugen.builders/mcp using HTTP transport.

Getting started

Once connected, a typical workflow looks like this:

1. Scaffold or extend an app, e.g. "Create a Cartesi Rollups v2 JavaScript echo app using cartesi-scaffold"
2. Run locally, e.g. "Give me the exact cartesi build and cartesi run commands for this project"
3. Interact and debug, e.g. "How do I send an ERC-20 deposit to my app?" or "My advance handler is rejecting inputs; help me debug"

Demo

See the MCP server in action: demo video. Claude scaffolds a Cartesi app from a single prompt, builds and runs it locally, interacts via text input and token deposits, and deploys to Base Sepolia.

Available tools

The server exposes developer-facing tools in three categories:

Knowledge search: find curated Cartesi resources and documentation routes:

• search_knowledge_resources: search repos, articles, docs, and skills by topic
• search_documentation_routes: find docs pages by keyword
• get_resource_detail: fetch metadata and related doc routes for a resource
• list_resources_for_tag / list_resources_for_source: browse by tag or source
• list_resource_doc_routes: list documentation routes linked to a resource
• get_knowledge_taxonomy / summarize_knowledge_base: explore what the knowledge base covers

Workflow helpers: generate step-by-step instructions to run on your machine:

• prepare_cartesi_create_command: scaffold a new app with the correct CLI flags for your CLI version
• prepare_cartesi_build_command / prepare_cartesi_run_command: build and run locally
• send_input_to_application: send generic inputs or deposits via the CLI
• prepare_erc20_deposit_instructions / prepare_erc721_deposit_instructions / prepare_erc1155_deposit_instructions: portal deposit workflows
• get_cartesi_app_logic_guidance: guidance for advance/inspect handlers, address-book usage, and outputs
• build_debugging_context: assemble docs and resources for a debugging query

Prompts: reusable prompt templates your assistant can invoke:

• find_cartesi_docs: locate the best documentation for a topic
• debug_cartesi_issue: investigate an error using curated knowledge
• explain_repository_context: understand a Cartesi repo before making changes