MCP Tools Reference

The Xenarch MCP server exposes three tools over the Model Context Protocol. Each is callable by Claude Desktop, Claude Code, or any MCP-compatible agent. Below: full input/output schemas and usage examples.

xenarch_check_gate

Check if a URL or domain has an x402 payment gate. Input:

Parameter	Type	Description
`url`	string	URL or domain to check. Accepts `https://example.com/article` or `example.com`.

Output (gated):

{
  "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"
}

Output (not gated):

{
  "gated": false,
  "message": "No Xenarch gate found for example.com"
}

xenarch_pay

Execute a USDC micropayment on Base L2 to access gated content. Input:

Parameter	Type	Required	Description
`url`	string	Yes	URL or domain to pay for. Must have an active gate.
`amount`	string	No	Override amount in USD (e.g., `"0.01"`). Defaults to gate price.

Output:

{
  "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"
}

Flow:

Checks for active gate (calls xenarch_check_gate internally)
Verifies USDC balance
Approves USDC on the splitter contract
Calls split(collector, amount) on-chain
Submits tx hash to the verify endpoint
Returns access token

xenarch_get_history

List past USDC micropayments made by this wallet. Input:

Parameter	Type	Required	Description
`domain`	string	No	Filter by domain (e.g., `"example.com"`). Omit for all.
`limit`	number	No	Max records (1-100, default 10).

Output:

{
  "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"
}

Getting Started

MCP Server

Smart Contract

Integrations

Examples

MCP Tools Reference

xenarch_check_gate

xenarch_pay

xenarch_get_history

​xenarch_check_gate

​xenarch_pay

​xenarch_get_history

xenarch_check_gate

xenarch_pay

xenarch_get_history