目录 / xenarch-mcp
MCP
鉴权未知
未评级
已上架
xenarch-mcp
Non-custodial x402 MCP server for AI agents. Lets Claude, Cursor, LangChain and CrewAI pay for HTTP 402–gated APIs with USDC micropayments on Base L2. Unlike Cloudflare Pay-Per-Crawl, works on any host and settles agent-to-publisher direct.
该来源不提供完整文件导出（国内平台多为平台内托管），仅存元数据与原链
接入信息
- 传输形态
- http
- 鉴权方式
- 鉴权未知
- 端点
https://xenarch-mcp--xenarch.run.tools
鉴权方式未标注，请核对官方文档后再接入——不要直接使用以下片段
{
"mcpServers": {
"xenarch-mcp": {
"url": "https://xenarch-mcp--xenarch.run.tools"
}
}
}
能力清单
| 工具 | 说明 |
|---|---|
| xenarch_check_gate | Check if a URL or domain has an x402 payment gate. Returns gate status, accepted payment requirements (price, asset, network), and the seller wallet. Use this before paying to confirm pricing, when a URL returns HTTP 402 Payment Required, or when a user asks whether content is paywalled. |
| xenarch_pay | Pay an x402-gated URL with USDC on Base L2 and return the gated content. Signs an EIP-3009 transferWithAuthorization, settles on-chain, then re-fetches the resource with proof of payment. Returns the on-chain tx_hash, seller wallet, and the response body. Settles directly to the seller wallet — no Xenarch contract in the money flow, no custodial balance. The agent wallet only ever holds USDC; no ETH or other gas coin is required. Use after xenarch_check_gate confirms a gate exists, or when the user asks to pay for or unlock gated content. |
| xenarch_wallet_status | Show the agent's local payment wallet: its address, USDC balance on Base, and whether it's funded. Use this to find the address the user needs to top up with USDC, or to check the balance before paying. This is the wallet that signs payments — separate from the wallet used to sign in to the dashboard. |
| xenarch_get_history | List past USDC micropayments made by this wallet through Xenarch. Returns transaction hashes, URLs, domains, amounts in USD, timestamps, total spend, and payment count. Optionally filter by domain. Use this to audit spending, check if you already paid for a resource, or track agent expenditure. |
| xenarch_agent_login | Sign in to the agent control plane using your browser wallet — no CLI needed. First call returns a link; open it, sign in with your wallet on the dashboard, and approve. Call this tool again to finish — the 7-day session is then used by every other xenarch_agent_* tool. Use this when a control-plane tool reports you're not signed in. |
| xenarch_agent_status | Show the operator's agent profile (name, paused state) and spend summary for a period. Read-only. Needs a SIWE session from `xenarch agent login`. |
| xenarch_agent_get_caps | Read the agent's spending caps (per-transaction, daily, monthly) and remaining headroom. Read-only. |
| xenarch_agent_set_caps | Set spending caps. Pass per_tx/daily/monthly in USD ('none' disables an axis); omit an axis to leave it unchanged. RAISING or REMOVING a cap requires confirm: true (returns needs_confirmation otherwise). Tightening is free. |
| xenarch_agent_reset_day_cap | Reset today's daily-spend counter back to the full daily cap (recovery from accidental mid-day exhaustion). Restores full spending headroom — requires confirm: true. |
| xenarch_agent_get_scope | Read the agent's scope: default posture (allow/deny) and the allow/deny rule list. Read-only. |
| xenarch_agent_add_scope_rule | Add an allow/deny scope rule. A 'deny' rule tightens (free); an 'allow' rule loosens and requires confirm: true. |
| xenarch_agent_remove_scope_rule | Remove a scope rule by id (full UUID or unambiguous prefix). Removing a DENY rule loosens scope and requires confirm: true. |
| xenarch_agent_set_default_scope | Set the default scope posture for unmatched URLs. 'deny' tightens (free); 'allow' loosens and requires confirm: true. |
| xenarch_agent_pause | Kill switch: pause the agent so all of its payments are blocked immediately. Tightening, so no confirm needed. |
| xenarch_agent_resume | Lift the pause so the agent can spend again (subject to caps + scope). Requires confirm: true. |
| xenarch_agent_list_keys | List the agent's xa_live_ API keys (id, label, last-used, revoked state). Never returns plaintext. Read-only. |
| xenarch_agent_create_key | Issue a new xa_live_ API key (plaintext returned once). Issues a live spending credential — requires confirm: true. |
| xenarch_agent_rotate_key | Rotate an API key by id (full UUID or prefix) — invalidates the old secret, returns a new one once. Requires confirm: true. |
| xenarch_agent_revoke_key | Permanently revoke an API key by id (full UUID or prefix). Requires confirm: true. |
| xenarch_agent_get_receipts | List the agent's payment receipts with filters (period, status, source, domain) and pagination. Read-only. |
| xenarch_list_links | List the merchant's pay-links (newest first), with cursor pagination. Read-only. Needs a SIWE session from `xenarch agent login`. |
| xenarch_get_link | Get one pay-link's detail (status, params, stats) by id. Read-only. |
| xenarch_create_link | Create a pay-link. VALIDATE-FIRST: call with mode:'validate' (default) to learn which fields are missing (each missing field includes a prompt to ask the user); once valid, call again with mode:'create' and confirm:true to sign + create. Signs with the agent's local key — the signer must equal the SIWE session wallet. Amount is USDC (max 1.00). |
| xenarch_revoke_link | Revoke a pay-link by id so it can no longer be paid. Requires confirm: true (returns needs_confirmation otherwise). |
| xenarch_list_payments | List payments RECEIVED across the merchant's pay-links (newest first), with cursor pagination. Read-only. |
| xenarch_list_subscribers | List subscribers across the merchant's subscription pay-links, with optional filters (link_id, status, mode). Read-only. |
| xenarch_get_merchant_profile | Get the merchant profile (issuer identity, domain verification status). Read-only. Returns null if none is set yet. |
| xenarch_update_merchant_profile | Update the merchant profile (issuer name, site, email, address, tax id, brand color, logo, payout rhythm). Only the fields you pass change; the rest are preserved (whole-state upsert). Rewrites customer-facing identity — requires confirm: true. |
| xenarch_verify_domain | Verify the merchant's domain via its DNS TXT record at _xenarch.<merchant_site> (XEN-394). Set merchant_site first via xenarch_update_merchant_profile. |
| xenarch_get_subscriber | Get one subscriber's full detail (plan, cadence, renewal dates, payer, permit/metered state) by subscription id. Read-only. |
| xenarch_get_subscriber_charges | Read a metered subscriber's immutable charge ledger (booked + settled charges, totals, outstanding). Read-only, cursor over charge_seq. |
| xenarch_get_subscriber_rollup | Subscriber KPIs: active count, MRR (USDC), 30-day churn. Read-only. |
| xenarch_cancel_subscriber | Cancel a subscription (merchant-initiated; reminder-mode only, 409 otherwise). Permanent. Requires confirm: true. |
| xenarch_suspend_subscriber | Suspend a subscription: collection attempts and dunning stop. Any mode, idempotent, no on-chain effect. Requires confirm: true. |
| xenarch_mint_manage_link | Mint a short-lived manage URL + token for a subscriber (hosted manage page). Anyone holding it can manage that subscription until expiry. Requires confirm: true. |
| xenarch_set_period_cap | Set/raise a metered-per-period subscriber's budget (new_cap_usdc). Mints the manage token behind the scenes. Requires confirm: true. |
| xenarch_list_permit_collectable | List permit subscriptions with a cycle due now (the collectable bag): amount, owner→spender transferFrom params, permit status. Read-only. |
| xenarch_list_metered_collectable | List metered subscriptions with booked charges awaiting on-chain settlement (the collectable bag). Read-only. |
| xenarch_fire_permit_digest | Dev/test: drop the throttle and immediately re-send the collectable digest email for your wallet. Requires confirm: true. |
| xenarch_permit_submit | Broadcast the buyer's signed USDC.permit on-chain to set the allowance (moves NO funds; wallet pays gas). Needs the LOCAL seller wallet key + Base ETH. Broadcasting requires confirm: true. Pass tx_hash alone to record an already-broadcast permit (recovery, record-only, no confirm needed). |
| xenarch_permit_collect | Collect one due permit cycle: preflights allowance/balance/simulation, broadcasts USDC.transferFrom from the LOCAL seller wallet (must be the permit spender, needs Base ETH gas), then books it. MOVES REAL MONEY — requires confirm: true PLUS expected_amount_usdc pinned from the needs_confirmation payload. If it reports transferred-but-not-booked, use xenarch_record_collect; NEVER re-run this tool for the same cycle. |
| xenarch_metered_collect | Settle a metered subscriber's booked charges on-chain: preflight, broadcast USDC.transferFrom from the LOCAL seller wallet, book. MOVES REAL MONEY — requires confirm: true PLUS expected_amount_usdc pinned from the needs_confirmation payload. If transferred-but-not-booked, use xenarch_record_collect; NEVER re-run this tool for the same charges. |
| xenarch_record_collect | Recovery: book an ALREADY-broadcast transferFrom by tx hash. Never transfers — the backend dedups on tx_hash, so it is always safe to re-run. |
| xenarch_edit_link | Replace a pay-link's metadata object (whole-state; null clears). Requires confirm: true. |
| xenarch_get_link_events | List a pay-link's event stream (views, payments, webhook fires…) with type filter + cursor. Read-only. |
| xenarch_get_links_rollup | Merchant pay-link KPIs: paid 24h/total, month-to-date revenue, views, conversion. Read-only. |
| xenarch_get_links_summary | Revenue / paid-count / link-count summary for a period (24h, 7d, 30d, all). Read-only. |
| xenarch_list_groups | List pay-link groups (name, accent, members). Read-only. |
| xenarch_create_group | Create a pay-link group. Requires confirm: true. |
| xenarch_update_group | Rename / re-accent / re-position a pay-link group. Requires confirm: true. |
| xenarch_delete_group | Delete a pay-link group (member links become ungrouped). Requires confirm: true. |
| xenarch_assign_link_group | Move a pay-link into a group (or null to ungroup). Requires confirm: true. |
| xenarch_list_orders | List paid orders across pay-links (buyer, shipping, status, tracking) with filters + cursor. Read-only. |
| xenarch_ship_order | Mark an order shipped with a tracking number — emails the buyer. Requires confirm: true. |
| xenarch_export_orders | Export orders as CSV text (same filters as list). Read-only. |
| xenarch_get_link_webhook | Read a pay-link's webhook config (URL, event types, enabled). Read-only. |
| xenarch_set_link_webhook | Set a pay-link's webhook URL / event types / enabled. Requires confirm: true. |
| xenarch_rotate_link_webhook_secret | Rotate a pay-link's webhook signing secret (old secret stops verifying). Requires confirm: true. |
| xenarch_test_link_webhook | Send a test event to a pay-link's webhook URL. Requires confirm: true. |
| xenarch_get_link_webhook_deliveries | List a pay-link's recent webhook delivery attempts (status, latency, errors). Read-only. |
| xenarch_retry_link_webhook_delivery | Re-send one failed pay-link webhook delivery. Requires confirm: true. |
| xenarch_get_agent_webhook | Read the agent's webhook config (URL, event types, enabled). Read-only. |
| xenarch_set_agent_webhook | Set the agent's webhook URL / event types / enabled. Requires confirm: true. |
| xenarch_rotate_agent_webhook_secret | Rotate the agent webhook's signing secret. Requires confirm: true. |
| xenarch_test_agent_webhook | Send a test event to the agent's webhook URL. Requires confirm: true. |
| xenarch_get_agent_webhook_deliveries | List the agent webhook's recent delivery attempts. Read-only. |
| xenarch_retry_agent_webhook_delivery | Re-send one failed agent webhook delivery. Requires confirm: true. |
| xenarch_update_agent_profile | Update the agent's display profile (display_name, label; null clears). Requires confirm: true. |
| xenarch_get_receipt | Get one payment receipt by id (from xenarch_agent_get_receipts). Read-only. |
| xenarch_list_sites | List the signed-in identity's sites (domain, price, gating, integration). Empty if the identity isn't a publisher yet. Read-only. |
| xenarch_add_site | Create a site (issues its site token; domain optional — the integration backfills it). Needs a verified account email. Requires confirm: true. |
| xenarch_get_site | Full site detail: gating config, pricing rules, token hash, integration. Read-only. |
| xenarch_delete_site | Permanently delete a site — its token stops working. Requires confirm: true. |
| xenarch_set_site_gating | Replace a site's gating config (master switch + category map, whole-state). Changes which bot traffic is charged/blocked. Requires confirm: true. |
| xenarch_set_site_pricing | Replace a site's pricing (default price/scope + per-path rules, whole-state). Requires confirm: true. |
| xenarch_rotate_site_token | Rotate a site's token — the integration must be updated or gating stops. Requires confirm: true. |
| xenarch_get_site_stats | Site earnings stats: gates, paid count, revenue, top pages, top agents. Read-only. |
| xenarch_get_site_activity | Site transaction feed (paid / blocked / withdrawals) with period + status filters, paginated. Read-only. |
| xenarch_get_site_categories | Per-bot-category earnings breakdown for a site. Read-only. |
| xenarch_get_publisher_gating | Read the publisher-level gating defaults (category map + per-bot overrides). Read-only. |
| xenarch_set_publisher_gating | Replace the publisher-level gating defaults — affects every site set to follow them. Requires confirm: true. |
| xenarch_create_site_claim | Mint a short-lived claim token so a plugin/worker/SDK can bootstrap its site token without copy-paste. Requires confirm: true. |
| xenarch_bot_catalog | The full bot signature catalog (name, category, company). Public, no auth. Read-only. |
| xenarch_bot_activity | Aggregated cross-site bot activity for the publisher (hits, sites seen, last seen per signature). Read-only. |
| xenarch_list_wallets | List the account's linked wallets (owner/default flags, labels, eligibility). Read-only. |
| xenarch_link_wallet | Link the agent's LOCAL wallet to your account as a co-wallet (key-held SIWE — signs with the local key). Requires confirm: true. |
| xenarch_unlink_wallet | Unlink a wallet from the account — it loses sign-in access. Requires confirm: true. |
| xenarch_set_wallet_label | Set/clear a linked wallet's nickname. Requires confirm: true. |
| xenarch_transfer_owner | Transfer account OWNERSHIP to another linked wallet. Hard to reverse. Requires confirm: true. |
| xenarch_list_merchant_keys | List the merchant's xm_live_ API keys (never returns plaintext). Read-only. |
| xenarch_create_merchant_key | Issue a new xm_live_ merchant API key (plaintext returned once). Requires confirm: true. |
| xenarch_rotate_merchant_key | Rotate a merchant API key — invalidates the old secret, returns a new one once. Requires confirm: true. |
| xenarch_revoke_merchant_key | Permanently revoke a merchant API key. Requires confirm: true. |
| xenarch_create_invite | Mint a co-owner join link (viewer / operator / full_co_owner). Anyone redeeming it joins your account. Requires confirm: true. |
| xenarch_list_invites | List outstanding (unredeemed) invites. Read-only. |
| xenarch_revoke_invite | Revoke a live invite before it's redeemed. Requires confirm: true. |
| xenarch_preview_invite | Preview a join link: which account it joins, role, expiry. Anonymous. Read-only. |
| xenarch_redeem_invite | Join another Xenarch account by invite token — the agent's LOCAL wallet signs SIWE and attaches to the inviter's identity. Requires confirm: true. |
| xenarch_set_account_email | Set the account email and send it a verification code (finish with xenarch_verify_account_email). Requires confirm: true. |
| xenarch_verify_account_email | Verify the account email with the emailed code. |
| xenarch_upload_asset | Upload an image (URL or base64, max 5 MB) to Xenarch's public CDN — for logos/branding. Returns the cdn.xenarch.dev URL. Requires confirm: true. |
| xenarch_get_earnings_summary | Earnings summary: today / this month / all-time (USD + payment counts). Read-only. |
| xenarch_pay_link | Pay a Xenarch pay-link by id (wrapped x402): fetches the link's payment envelope, settles EIP-3009 USDC on Base, and confirms the payment with the link. Use this for pay.xenarch.com/l/<id> links; use xenarch_pay for arbitrary x402-gated URLs. Pays from the agent wallet (USDC only, no gas needed). |
纠错与举报（发现条目失效、署名有误或涉及侵权？）
提交举报 / 纠错
侵权举报经核验成立后，我们会即时下线该条目并删除已存的内容副本。