io.github.xona-labs/xpay MCP Server

Name: io.github.xona-labs/xpay MCP Server
Author: io.github.xona-labs

io.github.xona-labs/xpay

Repository Registry

What is the io.github.xona-labs/xpay MCP server?

Xona Wallet: agent wallet for AI agents. x402 payments, AgenC hires, 20k+ services

How to install io.github.xona-labs/xpay

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

XPAY_PROFILE
Wallet profile to load or create (default: active profile, else "default")
XPAY_PASSPHRASE
secret
Encrypts the auto-generated wallet at rest; also unlocks an existing encrypted profile
XPAY_HOME
Override the ~/.xpay/ data directory
XPAY_NO_AUTO_WALLET
Set to error instead of auto-generating a wallet when none is configured
XPAY_SOLANA_SECRET
secret
Use an existing Solana secret key (base58) instead of the generated wallet
XPAY_EVM_KEY
secret
Use an existing EVM private key instead of the generated wallet
XPAY_EVM_NETWORK
EVM network for XPAY_EVM_KEY (e.g. base, stable, base-sepolia)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "xpay": {
      "command": "npx",
      "args": [
        "-y",
        "@xona-labs/xpay",
        "mcp"
      ],
      "env": {
        "XPAY_PROFILE": "<YOUR_XPAY_PROFILE>",
        "XPAY_PASSPHRASE": "<YOUR_XPAY_PASSPHRASE>",
        "XPAY_HOME": "<YOUR_XPAY_HOME>",
        "XPAY_NO_AUTO_WALLET": "<YOUR_XPAY_NO_AUTO_WALLET>",
        "XPAY_SOLANA_SECRET": "<YOUR_XPAY_SOLANA_SECRET>",
        "XPAY_EVM_KEY": "<YOUR_XPAY_EVM_KEY>",
        "XPAY_EVM_NETWORK": "<YOUR_XPAY_EVM_NETWORK>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "xpay": {
      "command": "npx",
      "args": [
        "-y",
        "@xona-labs/xpay",
        "mcp"
      ],
      "env": {
        "XPAY_PROFILE": "<YOUR_XPAY_PROFILE>",
        "XPAY_PASSPHRASE": "<YOUR_XPAY_PASSPHRASE>",
        "XPAY_HOME": "<YOUR_XPAY_HOME>",
        "XPAY_NO_AUTO_WALLET": "<YOUR_XPAY_NO_AUTO_WALLET>",
        "XPAY_SOLANA_SECRET": "<YOUR_XPAY_SOLANA_SECRET>",
        "XPAY_EVM_KEY": "<YOUR_XPAY_EVM_KEY>",
        "XPAY_EVM_NETWORK": "<YOUR_XPAY_EVM_NETWORK>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "xpay": {
      "command": "npx",
      "args": [
        "-y",
        "@xona-labs/xpay",
        "mcp"
      ],
      "env": {
        "XPAY_PROFILE": "<YOUR_XPAY_PROFILE>",
        "XPAY_PASSPHRASE": "<YOUR_XPAY_PASSPHRASE>",
        "XPAY_HOME": "<YOUR_XPAY_HOME>",
        "XPAY_NO_AUTO_WALLET": "<YOUR_XPAY_NO_AUTO_WALLET>",
        "XPAY_SOLANA_SECRET": "<YOUR_XPAY_SOLANA_SECRET>",
        "XPAY_EVM_KEY": "<YOUR_XPAY_EVM_KEY>",
        "XPAY_EVM_NETWORK": "<YOUR_XPAY_EVM_NETWORK>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "xpay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@xona-labs/xpay",
        "mcp"
      ],
      "env": {
        "XPAY_PROFILE": "<YOUR_XPAY_PROFILE>",
        "XPAY_PASSPHRASE": "<YOUR_XPAY_PASSPHRASE>",
        "XPAY_HOME": "<YOUR_XPAY_HOME>",
        "XPAY_NO_AUTO_WALLET": "<YOUR_XPAY_NO_AUTO_WALLET>",
        "XPAY_SOLANA_SECRET": "<YOUR_XPAY_SOLANA_SECRET>",
        "XPAY_EVM_KEY": "<YOUR_XPAY_EVM_KEY>",
        "XPAY_EVM_NETWORK": "<YOUR_XPAY_EVM_NETWORK>"
      }
    }
  }
}

Claude Code

claude mcp add xpay --env XPAY_PROFILE=<YOUR_XPAY_PROFILE> --env XPAY_PASSPHRASE=<YOUR_XPAY_PASSPHRASE> --env XPAY_HOME=<YOUR_XPAY_HOME> --env XPAY_NO_AUTO_WALLET=<YOUR_XPAY_NO_AUTO_WALLET> --env XPAY_SOLANA_SECRET=<YOUR_XPAY_SOLANA_SECRET> --env XPAY_EVM_KEY=<YOUR_XPAY_EVM_KEY> --env XPAY_EVM_NETWORK=<YOUR_XPAY_EVM_NETWORK> -- npx -y @xona-labs/xpay mcp