NestDaddy

Archipelago on Arc

io.github.RunTimeAdmin/archipelago-x402-mcp ยท v0.1.1

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

Connect Runs on your machine

Terminal
claude mcp add archipelago-x402-mcp -e BUYER_PRIVATE_KEY_FILE=<BUYER_PRIVATE_KEY_FILE> -e BUYER_PRIVATE_KEY=<BUYER_PRIVATE_KEY> -e ARCHIPELAGO_X402_MAX_PER_CALL=<ARCHIPELAGO_X402_MAX_PER_CALL> -e ARCHIPELAGO_X402_BUDGET=<ARCHIPELAGO_X402_BUDGET> -- npx -y @archipelagodex/[email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "archipelago-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@archipelagodex/[email protected]"
      ],
      "env": {
        "BUYER_PRIVATE_KEY_FILE": "<BUYER_PRIVATE_KEY_FILE>",
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "ARCHIPELAGO_X402_MAX_PER_CALL": "<ARCHIPELAGO_X402_MAX_PER_CALL>",
        "ARCHIPELAGO_X402_BUDGET": "<ARCHIPELAGO_X402_BUDGET>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "archipelago-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@archipelagodex/[email protected]"
      ],
      "env": {
        "BUYER_PRIVATE_KEY_FILE": "<BUYER_PRIVATE_KEY_FILE>",
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "ARCHIPELAGO_X402_MAX_PER_CALL": "<ARCHIPELAGO_X402_MAX_PER_CALL>",
        "ARCHIPELAGO_X402_BUDGET": "<ARCHIPELAGO_X402_BUDGET>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "archipelago-x402-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@archipelagodex/[email protected]"
      ],
      "env": {
        "BUYER_PRIVATE_KEY_FILE": "<BUYER_PRIVATE_KEY_FILE>",
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "ARCHIPELAGO_X402_MAX_PER_CALL": "<ARCHIPELAGO_X402_MAX_PER_CALL>",
        "ARCHIPELAGO_X402_BUDGET": "<ARCHIPELAGO_X402_BUDGET>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
BUYER_PRIVATE_KEY_FILE
Optional
Path 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_KEY
Optional, secret
The 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_CALL
Optional
The most one call may cost, in USDC (at most 1).
ARCHIPELAGO_X402_BUDGET
Optional
The most to count as paid or reserved per UTC day, in USDC, across restarts.

Details

Package@archipelagodex/[email protected] (NPM, stdio)
First published29 Oct 2026
Last updated29 Oct 2026
Registry nameio.github.RunTimeAdmin/archipelago-x402-mcp

More finance and crypto servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.