Is io.github.xenarch-ai/xenarch-mcp safe to use?

io.github.xenarch-ai/xenarch-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.xenarch-ai/xenarch-mcp?

io.github.xenarch-ai/xenarch-mcp can be installed by cloning its GitHub repository and following the setup instructions in the README.

What AI clients work with io.github.xenarch-ai/xenarch-mcp?

io.github.xenarch-ai/xenarch-mcp is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio transport.

xenarch-mcp

MCP servers for the Xenarch payment network. Lets AI agents discover and pay for services via USDC micropayments on Base.

How It Works

1. Discover    xenarch_check_gate("example.com")
               → { gated: true, price_usd: "0.003", protocol: "x402" }

2. Pay         xenarch_pay("example.com")
               → USDC sent on Base via splitter contract
               → { access_token: "eyJ...", expires_at: "..." }

3. Access      Re-request the URL with Authorization: Bearer <token>
               → Full content returned

No API keys. No signup. The agent pays directly on-chain — Xenarch never holds funds.

Agent MCP Server

Three tools for AI agents:

Tool	Description
`xenarch_check_gate`	Check if a URL/domain has a payment gate. Returns pricing and payment details.
`xenarch_pay`	Pay for gated content. Executes USDC payment on Base via the splitter contract.
`xenarch_get_history`	View past payments made by this wallet.

Example Responses

xenarch_check_gate

{
  "gated": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "price_usd": "0.003",
  "splitter": "0xC6D3a6B6fcCD6319432CDB72819cf317E88662ae",
  "collector": "0xabc123...publisher_wallet",
  "network": "base",
  "asset": "USDC",
  "protocol": "x402"
}

xenarch_pay

{
  "success": true,
  "tx_hash": "0xdef456...abc789",
  "block_number": 28451023,
  "amount_usd": "0.003",
  "url": "example.com",
  "access_token": "eyJhbGciOiJIUzI1NiJ9...",
  "expires_at": "2026-04-10T15:05:00Z",
  "wallet": "0x123...your_wallet"
}

xenarch_get_history

{
  "payments": [
    {
      "domain": "example.com",
      "amount_usd": "0.003",
      "tx_hash": "0xdef456...abc789",
      "paid_at": "2026-04-10T14:35:00Z"
    }
  ],
  "total_spent_usd": "0.003000",
  "count": 1,
  "wallet": "0x123...your_wallet"
}

Setup

Configure your wallet:

mkdir -p ~/.xenarch
cat > ~/.xenarch/wallet.json << 'EOF'
{
  "privateKey": "0xYOUR_PRIVATE_KEY"
}
EOF
chmod 600 ~/.xenarch/wallet.json

Add to Claude Code:

claude mcp add xenarch -- npx @xenarch/agent-mcp

Or add to Claude Desktop / any MCP client:

{
  "mcpServers": {
    "xenarch": {
      "command": "npx",
      "args": ["@xenarch/agent-mcp"],
      "env": {
        "XENARCH_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Environment Variables

Variable	Default	Description
`XENARCH_PRIVATE_KEY`	—	Wallet private key (overrides config file)
`XENARCH_RPC_URL`	`https://mainnet.base.org`	Base RPC endpoint
`XENARCH_API_BASE`	`https://api.xenarch.dev`	Xenarch platform API
`XENARCH_NETWORK`	`base`	Network (`base` or `base-sepolia`)
`XENARCH_AUTO_APPROVE_MAX`	—	Max USD to auto-approve without prompting

Examples

See xenarch-examples for working integration examples — Python agents, LangChain, CrewAI, Claude Desktop setup, and publisher middleware.

Development

npm install
npm run build

Structure

packages/
  shared/    — Payment logic, types, config (reused across servers)
  agent/     — MCP server for AI agents

License

MIT

io.github.xenarch-ai/xenarch-mcp

Quick Install

Should you use this server?

Test This Server

Score Breakdown

MCPpedia Score

Security

Help improve this page

Reviews

Frequently Asked Questions

Similar servers

Alpha Vantage Mcp

Mcp_massive

io.github.imbenrabi/financial-modeling-prep-mcp-server

Clawpay MCP Server

Discussion