x402 Agent-Payment Infrastructure

Call this first after connecting. Returns the operating playbook, first-call order, safe payment rules, tool routing map, examples, and links for using this MCP server without installing a separate skill.

Return the MCP-native README/playbook summary with docs links, workflows, safety rules, and recommended next calls.

Generic alias for start_here. Useful for agents and probes looking for an MCP server playbook.

Generic alias for start_here. Useful for agents and probes looking for instructions before using paid tools.

Namespaced alias for start_here. Returns the agent operating playbook, safe payment flow, first-call order, tool routing map, and examples for using x402 payments, hosted endpoints, creator catalogs, conversion handoffs, receipts, and builder controls.

Alias for wisely_start_here. Returns the Wisely agent-payment playbook for MCP-only clients and registry probes.

Alias for wisely_start_here. Returns concise instructions an AI agent should follow before quoting, paying, invoking, creating endpoints, or handling receipts through Wisely.

Plain-English install/download alias. Returns the portable Wisely package profile, GitHub install command, MCP URL, CLI commands, and local bridge setup path for OpenClaw, Hermes-style agents, ChatGPT MCP clients, and generic MCP clients.

Alias for install_skill. Use when an agent or user asks how to download, install, or add Wisely abilities without ClawMart.

Call this when a user wants DoorDash or another merchant flow to run from their own local browser instead of Wisely's server. Returns a clear novice setup guide, local MCP config, credential policy, expected local tools, and step-by-step install/start/test instructions. Do not ask for merchant passwords in chat.

Plain-English alias for wisely_local_commerce_bridge_setup. Use when a ChatGPT/OpenClaw/Hermes-style agent needs to help the user install the localhost bridge for DoorDash, merchant checkout, local wallet signing, and local receipt/gift-card storage.

Alias for wisely_local_commerce_bridge_setup focused on local wallet signing and proof storage. Returns setup instructions for wallet_open_signing_url, wallet_payment_session_status, local_vault_save, and local_vault_list.

Alias for setup_local_wallet_bridge. Use when the user wants their wallet to stay local while the agent uses Wisely x402 payment sessions.

Alias for setup_local_wallet_bridge. Use for crypto-to-gift-card flows where the user signs locally and wants receipts or gift-card records saved locally.

Alias for wisely_local_commerce_bridge_setup. Use for local browser, DoorDash, merchant checkout, or user-owned session setup.

Alias for wisely_local_commerce_bridge_setup. Returns the local browser bridge setup guide for agents connecting by MCP without ClawMart.

Return the public service/payment manifest.

Return portable install metadata for OpenClaw, Hermes-style agents, Codex/CLI agents, MCP clients, and Bankr-style skill registries.

Return public-safe endpoint wiring, discovery, and verifier readiness checks.

Return proof-based readiness for Base, Solana, XRPL, Stellar, LINK, conversion, and scale gates.

Return combined MCP, hosted endpoint, provider-method, rail, conversion, receipt, and alert readiness for outside agents.

Return public-safe alerting status and recent rail/provider operational notices.

Return public-safe durable-state status, migration metadata, DB counts, and JSON compatibility status.

Return public-safe maintenance worker status for reconciliation, alerts, and state migration checks.

Return the latest cached public proof bundle for Base, Solana, manifests, receipts, and reconciliation.

Return public-safe seller report freshness and totals without private payout secrets.

Return public-safe signer gateway/custody status and KMS/HSM migration readiness for the Base facilitator relayer.

Quote a Wisely-hosted AI/data service and payment route.

Create a short-lived hosted wallet signing session for ChatGPT/MCP clients. The user opens a signing URL, chooses an injected wallet, mobile wallet app, or configured WalletConnect, signs in their own wallet, then the agent polls status and retries with X-PAYMENT. No private keys or seed phrases are accepted.

Plain-English alias for x402_wallet_handoff. Use when a user asks how to connect a wallet to ChatGPT or another MCP agent for Wisely x402 payments. Returns a hosted signing URL with wallet-app links and provider selection.

Check a wallet handoff session. After the user signs, returns the signed X-PAYMENT header and paid-retry instructions for the agent.

Quote a live executable conversion from the caller's crypto into required Base USDC x402 settlement.

List supported and planned input assets for the Wisely casa de cambio conversion handoff layer.

Return the current executable and planned conversion route status matrix.

Invoke a paid service through /ai/invoke with x402 proof or developer credit.

Create or top up reusable developer credits through x402.

Read developer-credit account status with a developer key.

Fetch a public-safe receipt by receipt id.

Probe a third-party x402 seller URL or accept pasted paymentRequirements, then quote how to satisfy it from the caller's crypto.

Return the Rye x402 checkout-intent flow for commerce URL checkout attempts, including DoorDash-via-Rye caveats, quote examples, and final-confirmation approval rules.

Return the gift-card-funded commerce lane status, provider readiness, DoorDash disabled gate, pricing/reserve policy, and safe setup steps.

Search Bitrefill-supported gift-card merchants by category or query, returning product IDs, countries, stock, minimums, maxes, custom/fixed denomination data, and quote endpoints.

Quote any Bitrefill-supported merchant gift-card purchase after product details are fetched, using $0.75 + 1% plus explicit route/network costs.

Quote a gift-card-funded merchant purchase with a $0.75 direct commerce service fee, 1% Wisely fee, and explicit gas/network/route costs. No gift card is purchased and no order is placed.

Return or run the full DoorDash gift-card-funded quote flow: cart totals, Bitrefill custom range, $15 minimum, crypto conversion/gas, $0.75 service fee, 1% fee, approval packet, and execution stages.

Explain the admin-only encrypted gift-card asset ledger for residual balances and redemption material. Does not reveal secrets.

Create a public-safe gift-card commerce intent record for follow-through/status streaming without storing full address, password, or redemption-code secrets.

List hosted paid x402 endpoints under /tools/{slug}.

List public creator catalogs that expose approved lessons, worksheets, and paid tools to AI agents.

Search a creator catalog for the best approved free, subscriber, or paid item for a user's situation.

Recommend the next creator-catalog action for a subscriber situation, including fetch instructions or paid endpoint 402 probe instructions.

Fetch a creator catalog item. Paid items return a paid endpoint URL and payment instructions instead of protected content.

Preview a creator catalog import from Markdown, CSV, JSON, or item arrays. Does not persist content or create paid endpoints.

Explain how to publish creator catalogs with entitlement rules, paid actions, and builder-key controlled paid endpoint creation.

Return public dashboard telemetry for traffic, receipts, fees, and endpoint usage.

Return endpoint-factory instructions for builder registration, create/update/pause/resume/delete/logs/secrets, CLI deploy, browser console, and request-response handlers.

Return portable endpoint-factory instructions and buyer handoff guidance for agents that create or manage paid x402 endpoints.

Register for a builder key through x402, developer credit, or admin issue; returned key controls only that builder's endpoints.

Read builder account and owned endpoint status with a saved builder key.

Read builder-owned endpoint revenue, fees, estimated payable balance, receipt IDs, and settlement notes with a saved builder key.

Read builder-owned endpoint revenue, fees, estimated payable balance, receipt IDs, and settlement notes with a saved builder key.

Read/update payout settings and create manual payout request packets without moving funds.

Search builder-owned endpoint events by time range, endpoint, type, or receipt id.

Search builder-owned endpoint events by time range, endpoint, type, or receipt id.

Explain how endpoint-scoped encrypted secrets are added and listed by name without returning secret values.