Skip to main content
@xenarch/agent-mcp 1.3.1 registers 103 tools. Every tool returns its result as JSON text. On failure the tool returns an error message with isError: true. This page documents the five buying tools in full, then lists the other 98 by group.

Buying tools

xenarch_check_gate

Reads the x402 payment requirements of a Xenarch-gated URL or domain. Read-only. A full URL is requested directly, and the tool reads the 402 body. A bare domain is looked up with GET /v1/gates/domain/{domain} on the Xenarch API. Output when gated:
maxAmountRequired is in USDC base units (6 decimals), so "3000" is $0.003. payTo and seller_wallet are the seller’s own wallet. Output when not gated:
A URL that answers 402 without a Xenarch gate_id counts as not gated.

xenarch_pay

Pays a Xenarch gate in USDC on Base and returns the content. What it does:
  1. Finds the gate, the same way as xenarch_check_gate.
  2. Refuses if the price is above XENARCH_MAX_PAYMENT_USD (default $1).
  3. Calls POST /v1/agent/preflight with XENARCH_API_TOKEN. The platform checks the pause switch, scope rules and per-transaction, daily and monthly caps. Without a token, the tool refuses.
  4. Signs an EIP-3009 transferWithAuthorization for USDC (EIP-712 domain “USD Coin”, version 2, chain 8453) from the agent wallet to payTo. The authorization is valid for 10 minutes.
  5. Posts it to each facilitator’s /settle endpoint in the listed order. The first facilitator that succeeds submits the transfer on Base and pays the gas.
  6. Requests the URL again with X-Xenarch-Gate-Id and X-Xenarch-Tx-Hash.
  7. Saves the full response body to ~/.xenarch/paid/<gate_id>.<ext> and returns a preview of up to 2,000 characters.
  8. Confirms the payment with POST /v1/gates/{gate_id}/verify and reports a receipt to your agent’s dashboard.
Output on success:
facilitator is the URL of the facilitator that settled. verified is null if the verify call failed. The on-chain transfer stands either way. Output when refused:
If no facilitator settles, or the second request fails after payment, the tool returns an error. In the second case the message includes the transaction hash. Pays a Xenarch pay link (pay.xenarch.com/l/<id>) by id. The tool gets the link’s x402 envelope from POST /v1/links/{link_id}/initiate, runs the same preflight as xenarch_pay, settles through a facilitator, and confirms with POST /v1/links/{link_id}/claim. Open-amount links cannot be paid with this tool. Output:
claim.status is confirmed, underpaid or overpaid.

xenarch_get_history

Lists payments made by the agent wallet, from GET /v1/payments/history. Read-only. Output:
Without XENARCH_API_TOKEN, the output also has a tip field that points to the dashboard.

xenarch_wallet_status

Shows the agent’s payment wallet. Takes no input. Read-only. Output:

Account tools

The other 98 tools manage a Xenarch account. They use the wallet session that xenarch agent login writes to ~/.xenarch/config.json, or the one xenarch_agent_login creates from inside the client. A session lasts 7 days. Tools that loosen limits, issue credentials, change live settings or move money return a needs_confirmation payload first. Call them again with confirm: true to proceed. Tools that only tighten limits, such as xenarch_agent_pause, run without confirmation.

Agent control plane (16)

xenarch_list_links, xenarch_get_link, xenarch_create_link, xenarch_revoke_link, xenarch_list_payments, xenarch_list_subscribers, xenarch_get_merchant_profile, xenarch_update_merchant_profile, xenarch_verify_domain. xenarch_create_link validates first. Call it with mode: "validate" to see missing fields, then with mode: "create" and confirm: true. It signs the link with the local wallet, which must be the wallet of the session. See Pay links. xenarch_edit_link, xenarch_get_link_events, xenarch_get_links_rollup, xenarch_get_links_summary, xenarch_list_groups, xenarch_create_group, xenarch_update_group, xenarch_delete_group, xenarch_assign_link_group, xenarch_list_orders, xenarch_ship_order, xenarch_export_orders. xenarch_get_link_webhook, xenarch_set_link_webhook, xenarch_rotate_link_webhook_secret, xenarch_test_link_webhook, xenarch_get_link_webhook_deliveries, xenarch_retry_link_webhook_delivery. See Webhooks.

Subscribers (10)

xenarch_get_subscriber, xenarch_get_subscriber_charges, xenarch_get_subscriber_rollup, xenarch_cancel_subscriber, xenarch_suspend_subscriber, xenarch_mint_manage_link, xenarch_set_period_cap, xenarch_list_permit_collectable, xenarch_list_metered_collectable, xenarch_fire_permit_digest. See Subscriptions.

On-chain collection (4)

xenarch_permit_submit, xenarch_permit_collect, xenarch_metered_collect, xenarch_record_collect. The first three send transactions from the seller wallet’s local key, so that wallet needs a little ETH on Base for gas. xenarch_permit_collect and xenarch_metered_collect move USDC and need confirm: true plus the expected_amount_usdc from the confirmation payload. If a transfer went through but was not booked, use xenarch_record_collect with the transaction hash. Do not run the collect tool again for the same cycle.

Agent webhooks, profile and receipts (8)

xenarch_get_agent_webhook, xenarch_set_agent_webhook, xenarch_rotate_agent_webhook_secret, xenarch_test_agent_webhook, xenarch_get_agent_webhook_deliveries, xenarch_retry_agent_webhook_delivery, xenarch_update_agent_profile, xenarch_get_receipt.

Sites, gating and bots (15)

xenarch_list_sites, xenarch_add_site, xenarch_get_site, xenarch_delete_site, xenarch_set_site_gating, xenarch_set_site_pricing, xenarch_rotate_site_token, xenarch_get_site_stats, xenarch_get_site_activity, xenarch_get_site_categories, xenarch_get_publisher_gating, xenarch_set_publisher_gating, xenarch_create_site_claim, xenarch_bot_catalog, xenarch_bot_activity. xenarch_bot_catalog and xenarch_preview_invite need no session.

Account, wallets, keys and invites (18)

xenarch_list_wallets, xenarch_link_wallet, xenarch_unlink_wallet, xenarch_set_wallet_label, xenarch_transfer_owner, xenarch_list_merchant_keys, xenarch_create_merchant_key, xenarch_rotate_merchant_key, xenarch_revoke_merchant_key, xenarch_create_invite, xenarch_list_invites, xenarch_revoke_invite, xenarch_preview_invite, xenarch_redeem_invite, xenarch_set_account_email, xenarch_verify_account_email, xenarch_upload_asset, xenarch_get_earnings_summary.

Resource and prompt

The server also exposes the resource xenarch://pricing, a JSON summary of the payment flow, and the prompt pay-for-content, which walks an agent through checking a URL, confirming the price with the user and paying.