# Scdo Agent MCP

> Scdo Agent MCP is a free MCP server for finance and payments. Agent wallet, x402 USDC payment and Agent Ledger tools from SCDO, run via uvx. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, Linux, self-hosted
- **Website:** https://scdo.com.au/linux-agent/
- **Repository:** https://github.com/scdolab/scdo-agent-plugins/tree/HEAD/packages/mcp-python
- **MCP Registry name:** io.github.SCDOLAB/scdo-agent-mcp
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add scdo-agent-mcp -- uvx scdo-agent-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

```json
{
  "mcpServers": {
    "scdo-agent-mcp": {
      "command": "uvx",
      "args": [
        "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

- [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.
- [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.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/scdo-agent-mcp
