Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xenarch.com/llms.txt

Use this file to discover all available pages before exploring further.

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:
ParameterTypeDescription
urlstringURL 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:
ParameterTypeRequiredDescription
urlstringYesURL or domain to pay for. Must have an active gate.
amountstringNoOverride 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:
  1. Checks for active gate (calls xenarch_check_gate internally)
  2. Verifies USDC balance
  3. Approves USDC on the splitter contract
  4. Calls split(collector, amount) on-chain
  5. Submits tx hash to the verify endpoint
  6. Returns access token

​
xenarch_get_history

List past USDC micropayments made by this wallet. Input:
ParameterTypeRequiredDescription
domainstringNoFilter by domain (e.g., "example.com"). Omit for all.
limitnumberNoMax 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"
}