Home/Use x402

Use x402

Pay for x402 resources — from your browser with your own wallet, or hands-free from your AI agent. Same protocol, same facilitator, six official ways in.

// Part 1 · Pay from your browser — the Universal x402 Client
One page: find it, pay it, keep the receipt

The Universal x402 Client is the easiest way to use x402 resources — no code, no keys pasted anywhere. Connect Pera or Lute and everything happens with wallet signatures.

Find anything

Search, filter and browse merchants and resources with the exact same filter set as the x402 Intelligence dashboard — network, chain, currency, source, time range, country — plus the raw Bazaar catalog for brand-new listings.

Pay in one click

The client shows you the live price from the resource's own 402 challenge, your wallet signs a single USDC transfer, and the facilitator settles it on-chain — network fees sponsored.

See what you bought

Responses render beautifully — JSON as a collapsible tree with copy and download, images inline, HTML sandboxed. Every MainNet purchase gets a Universal Receipt link.

Your history & totals

Per-wallet history of everything you've done — purchases, verifies, settles — with your own totals up top: merchants used, resources bought, payments and volume.

Rate what you bought — optional

Leave verified 5-star feedback (plus a message) on any purchase — itself a small paid x402 function (0.05 USDC on Algorand MainNet), so only real buyers can rate, and your rating rides permanently in the payment's on-chain note. This feedback directly affects merchant and resource ranking and reputation across x402 — your voice shapes who rises.

Your keys never leave your wallet. Payments are gasless — the facilitator's fee payer covers per-payment network fees; your account only needs Algorand's standard minimum balance (0.1 ALGO base + 0.1 ALGO for the USDC opt-in, locked, never spent on payments).
// Part 2 · Let your agent pay — official plugins
Claude Code

Run inside Claude Code:

/plugin marketplace add GoPlausible/claude-plugins
/plugin install algorand-plugin@goplausible-claude-plugins

Ships the full Algorand MCP toolset plus x402 skills — your agent recognizes an HTTP 402 on its own, checks the price, and completes the payment without you lifting a finger. Optional — skip per-tool prompts by allowing the plugin's tools in .claude/settings.json (or ~/.claude/settings.json):

{
  "permissions": {
    "allow": [
      "mcp__plugin_algorand-plugin_algorand-mcp__*",
      "Read(/skills/**)",
      "Read(/references/**)"
    ]
  }
}
OpenAI Codex

Run in your terminal:

codex plugin marketplace add https://github.com/GoPlausible/codex-plugins.git
codex plugin add algorand@goplausible

Restart Codex (or start a new thread) and verify with /mcp — you should see algorand-mcp. Optional — skip per-tool approval prompts in ~/.codex/config.toml:

[plugins."algorand@goplausible".mcp_servers."algorand-mcp"]
enabled = true
default_tools_approval_mode = "approve"
OpenClaw
openclaw plugins install @goplausible/algorand-plugin
openclaw gateway restart
openclaw algorand-plugin setup
openclaw gateway restart

Tools surface through mcporter — the same one-go payment call looks like this:

mcporter call algorand-mcp.make_http_request_with_x402 --args '{
  "baseURL": "https://example.x402.goplausible.xyz",
  "path": "/avm/weather",
  "method": "GET",
  "preferredNetwork": "testnet",
  "maxAmountPerRequest": 10000
}'
// Part 3 · Or connect a remote MCP server directly

Prefer no local install at all? The plugins above bundle the local Algorand MCP (keys in an encrypted on-device wallet) — but any MCP-capable client can also connect straight to the hosted servers below, where no keys ever live on your machine.

Remote — hosted wallet, OAuth sign-in

No keys at all on your side. Sign in with Google, GitHub, X or LinkedIn; your Algorand account lives in a HashiCorp Vault and signs server-side. Full toolset including the knowledge base and DEX tools. Operates on Algorand MainNet only — real funds, real payments.

{
  "mcpServers": {
    "algorand-remote-mcp": {
      "command": "npx",
      "args": ["mcp-remote", "https://algorandmcp.goplausible.xyz/sse"]
    }
  }
}
Remote Lite — hosted wallet + interactive widgets

Same OAuth + Vault wallet as Remote, trimmed toolset, and MCP Apps UI widgets — payment confirmations, x402 requirements and Bazaar results render as interactive cards in clients that support them. Operates on Algorand MainNet only — real funds, real payments.

{
  "mcpServers": {
    "algorand-remote-mcp-lite": {
      "command": "npx",
      "args": ["mcp-remote", "https://algorandmcplite.goplausible.xyz/sse"]
    }
  }
}
Start every session by loading the skill

Both remote servers ship an algorand_mcp_skill tool — a built-in operating manual covering every tool, the x402 payment flow and the safety rails. The optimum way to start a session with either MCP is to ask your agent to read it first; the agent then knows exactly how to discover, price and purchase without trial and error:

Read the Algorand MCP skill and follow it for this session.
// Part 4 · Every one of them speaks the same x402

All six surfaces — three plugins, three MCP servers — expose the same five tools, discover resources from the same Bazaar, and settle through this facilitator (https://facilitator.goplausible.xyz) by default:

ToolWhat it does
make_http_request_with_x402The one-go call. Fetches the URL; on 402 it reads the payment requirements, builds the atomic group (facilitator fee-payer first, your USDC transfer second), signs, retries with PAYMENT-SIGNATURE, and returns the paid response — one tool call, no manual steps.
x402_discover_payment_requirementsPeek at a resource's price, asset and networks without paying — inspect-then-pay when you want explicit control.
bazaar_listBrowse everything cataloged in the Bazaar.
bazaar_searchFind resources by keyword, network or price.
bazaar_get_resource_detailsFull listing for one resource — description, schema, accepts, pricing.
Header PAYMENT-SIGNATURE (x402 v2) MainNet USDC asset 31566704 TestNet USDC asset 10458941 Gasless facilitator fee payer co-signs

Built-in discipline, identical everywhere: always cap spend with maxAmountPerRequest, default to preferredNetwork: "testnet", and confirm before paying on MainNet. The two payment tools are name- and shape-compatible with Coinbase's x402 MCP tools, so agents written against those work here unchanged.

Four ways to make a purchase — each prompt works verbatim in any of the plugins and MCPs above; copy the one that matches how you shop:

1 · Find it on the Bazaar, then buy
Search the x402 Bazaar for weather APIs on Algorand TestNet, pick the
cheapest one and buy it — cap spend at 10000 microUSDC.
2 · Buy a URL you already know
Fetch https://example.x402.goplausible.xyz/avm/weather and pay if
required — cap it at 10000 microUSDC, TestNet.
3 · Check the price first, then buy
Discover the payment requirements for
https://example.x402.goplausible.xyz/avm/weather — show me the price and
asset — then complete the purchase on TestNet.
4 · Buy on MainNet — with confirmation
Search the Bazaar for LLM inference APIs on Algorand MainNet under
0.2 USDC per call, show me the exact price, then buy one call — confirm
with me before paying.
// Part 5 · Keep exploring