# xenarch-mcp

xenarch-mcp enables AI agents to handle HTTP 402 micropayments with USDC on Base L2. Lets tools pay sellers directly without custodial middlemen.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 974 installs
- Author: xenarch
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/xenarch/xenarch-mcp
- Updated: 2026-04-11
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/xenarch-mcp

## What it does

This server implements the x402 protocol so agents can pay for gated resources on the fly. When a server returns HTTP 402 Payment Required, the agent inspects payment requirements through `xenarch_check_gate`. It signs an EIP-3009 transfer authorization, settles on Base L2, and fetches the payload immediately via `xenarch_pay`. Settlements go straight to seller wallets.

Operators manage spending through strict caps and domain scopes. You can define per-transaction, daily, and monthly limits. Without USDC in the local agent wallet, gated calls will fail. Loosening any restriction or raising budget ceilings requires setting `confirm: true`.

The server also supports merchant tools. Through SIWE dashboard authentication, agents can mint pay-links, track incoming subscriber revenue, and verify domains via DNS records.

## Requirements
- Remote server: `https://xenarch-mcp--xenarch.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http xenarch-mcp https://xenarch-mcp--xenarch.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add xenarch-mcp --url https://xenarch-mcp--xenarch.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xenarch-mcp": {
            "url": "https://xenarch-mcp--xenarch.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "xenarch-mcp": {
            "type": "http",
            "url": "https://xenarch-mcp--xenarch.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http xenarch-mcp https://xenarch-mcp--xenarch.run.tools
```

## When to use it
- pay for HTTP 402 paywalled endpoints using USDC on Base L2
- inspect gate pricing and recipient wallets before settling
- restrict agent spending caps per transaction, day, or month
- generate and revoke merchant payment links or subscription plans

## Example prompts
- Check the local agent wallet address and USDC balance using `xenarch_wallet_status`.
- Inspect gate conditions and pricing for the target endpoint via `xenarch_check_gate`.
- Set a daily spend cap of 15 dollars using `xenarch_agent_set_caps`.

## Similar
- [mcp-x402](https://affpapa.org/en/nevibecode/mcp/mcp-x402.md) — MCP server · ★ 279 repo stars
- [Neuronto Payments: x402 facilitator and API gateway](https://affpapa.org/en/nevibecode/mcp/neuronto-payments-x402-facilitator-and-api-gateway.md) — MCP server
- [FiatDock](https://affpapa.org/en/nevibecode/mcp/fiatdock.md) — MCP server · ★ 1 repo stars
- [mcp](https://affpapa.org/en/nevibecode/mcp/walletbureau-mcp.md) — MCP server
- [pay-via-agent-wallet](https://affpapa.org/en/nevibecode/skills/pay-via-agent-wallet.md) — skill · 859 installs
- [Agent402.Tools: pay-per-call web tools](https://affpapa.org/en/nevibecode/mcp/agent402tools-pay-per-call-web-tools.md) — MCP server · ★ 52 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
