Skip to content
MCP server

Scdo Agent MCP

Agent wallet, x402 USDC payment and Agent Ledger tools from SCDO, run via uvx

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, Linux, self-hosted
Runs
Locally
Version
0.2.0
Listing updated
2 days ago

About Scdo Agent MCP

Scdo Agent MCP is a free MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

This Python package gives an agent access to SCDO's agent tooling over stdio. The registry entry lists its areas as an x402 USDC wallet, the SCDO Agent Ledger, the SCDO chain, games and Connect. Start it with uvx scdo-agent-mcp; the SCDO_AGENT_NETWORK setting chooses Base mainnet, the default, or the Base Sepolia test network.

It sits alongside scdo-agent, a headless Linux daemon described on the same site. In that daemon each agent runs as its own systemd instance with its own key, signs heartbeats and bookkeeping entries, and appears on a public ledger whose batches are anchored on SCDO Shard0 (chain ID 5680) as Merkle roots. Wallet commands there include create, limit, freeze and pay, with per-payment and 24-hour USDC caps. On Base, a facilitator pays gas, so a wallet needs USDC but no ETH.

The site describes a free design-partner pilot for the first 10 operators. Registering agents and signing bookkeeping entries carries no fee, with limits of 10 new agents per IP per day and 120 signed requests a minute. Keys stay on your own server.

Install

Run in a terminal

claude mcp add scdo-agent-mcp -- uvx scdo-agent-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "scdo-agent-mcp": {
      "command": "uvx",
      "args": [
        "scdo-agent-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "scdo-agent-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "scdo-agent-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "scdo-agent-mcp": {
      "command": "uvx",
      "args": [
        "scdo-agent-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "scdo-agent-mcp": {
      "command": "uvx",
      "args": [
        "scdo-agent-mcp"
      ]
    }
  }
}

Configuration

  • SCDO_AGENT_NETWORKbase (default) or base-sepolia
  • SCDO_AGENT_DATAscdo-agent data dir

What it does

x402 USDC payments
Agents pay and serve paywalled endpoints in USDC on Base.
Spending caps
Per-payment and 24-hour USDC limits on each agent wallet.
Signed bookkeeping
Agents sign heartbeats and entries that appear on a public ledger.
Test network option
Switch to Base Sepolia for testing with the network setting.
Local keys
Wallet keys are kept on your server; the ledger holds none.
Optional on-chain identity
Agents can register an ERC-8004 identity on Shard0.

Good for

  • Give an agent a capped USDC wallet for paying x402 services
  • Run a paywalled endpoint that an agent can charge for
  • Keep a signed, auditable record of each agent's activity
  • Try payment flows on Base Sepolia before using real USDC

Pricing

Free

Free design-partner pilot for the first 10 operators; no fee to register agents or sign entries

Prices change. Check scdo.com.au before you buy.

Scdo Agent MCP FAQ

How do I run it?

With uvx scdo-agent-mcp; set SCDO_AGENT_NETWORK to base or base-sepolia.

Do wallets need ETH for gas?

No. The facilitator pays the gas, so agent wallets need USDC only.

What does it cost?

The site describes a free design-partner pilot for the first 10 operators, and no fee for registering agents or signing entries.

Where are keys stored?

On your own server; the ledger only checks signatures.

Is Scdo Agent MCP free?

Yes. Scdo Agent MCP is free to use.

How do I add Scdo Agent MCP to Claude Code?

Run this command in your terminal: claude mcp add scdo-agent-mcp -- uvx scdo-agent-mcp

What are the best alternatives to Scdo Agent MCP?

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

Alternatives to Scdo Agent MCP

  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