@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:
gate_id counts as not gated.
xenarch_pay
Pays a Xenarch gate in USDC on Base and returns the content.
What it does:
- Finds the gate, the same way as
xenarch_check_gate. - Refuses if the price is above
XENARCH_MAX_PAYMENT_USD(default $1). - Calls
POST /v1/agent/preflightwithXENARCH_API_TOKEN. The platform checks the pause switch, scope rules and per-transaction, daily and monthly caps. Without a token, the tool refuses. - Signs an EIP-3009
transferWithAuthorizationfor USDC (EIP-712 domain “USD Coin”, version 2, chain 8453) from the agent wallet topayTo. The authorization is valid for 10 minutes. - Posts it to each facilitator’s
/settleendpoint in the listed order. The first facilitator that succeeds submits the transfer on Base and pays the gas. - Requests the URL again with
X-Xenarch-Gate-IdandX-Xenarch-Tx-Hash. - Saves the full response body to
~/.xenarch/paid/<gate_id>.<ext>and returns a preview of up to 2,000 characters. - Confirms the payment with
POST /v1/gates/{gate_id}/verifyand reports a receipt to your agent’s dashboard.
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.
xenarch_pay_link
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, fromGET /v1/payments/history. Read-only.
Output:
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 thatxenarch 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)
Pay links and merchant profile (9)
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.
Pay link details, groups and orders (12)
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.
Pay link webhooks (6)
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 resourcexenarch://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.