Skip to content
MCP server

Archipelago on Arc

Buy Archipelago's Arc token reports, exit costs and wallet balances over x402, within…

Runs locallyStatus and history
Install
Runs
Locally
Version
0.1.1
Listing updated
6 days ago

About Archipelago on Arc

Archipelago on Arc is an MCP server. It runs locally on your machine and is started by your AI client.

Buy Archipelago's Arc token reports, exit costs and wallet balances over x402, within caps you set.

Install

Run in a terminal

claude mcp add archipelago-x402-mcp --env BUYER_PRIVATE_KEY='<BUYER_PRIVATE_KEY>' -- npx -y @archipelagodex/archipelago-x402-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "archipelago-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@archipelagodex/archipelago-x402-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "archipelago-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@archipelagodex/archipelago-x402-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "archipelago-x402-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@archipelagodex/archipelago-x402-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "archipelago-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@archipelagodex/archipelago-x402-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "archipelago-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@archipelagodex/archipelago-x402-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BUYER_PRIVATE_KEY_FILEPath of a file whose first word is the private key of a dedicated wallet that holds only the USDC (on Arc) you are willing to spend. Without a key only the free tools appear.
  • BUYER_PRIVATE_KEYThe same private key given directly, for a client that keeps its configuration private. A key file is safer: a key typed into a command line lands in shell history.
  • ARCHIPELAGO_X402_MAX_PER_CALLThe most one call may cost, in USDC (at most 1).
  • ARCHIPELAGO_X402_BUDGETThe most to count as paid or reserved per UTC day, in USDC, across restarts.

Archipelago on Arc FAQ

How do I add Archipelago on Arc to Claude Code?

Run this command in your terminal: claude mcp add archipelago-x402-mcp --env BUYER_PRIVATE_KEY='<BUYER_PRIVATE_KEY>' -- npx -y @archipelagodex/archipelago-x402-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers