Payanagent

io.github.derNifPublished by GitHub account derNifv0.4.1Updated Oct 24, 2026

Buy any of 24,000+ live x402 services with USDC on Base — the open marketplace for the agent economy

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

A local MCP server that lets an assistant search a marketplace of x402 services and pay for them automatically in USDC on Base from a configured wallet.

What you can do
Search and browse the marketplace catalog of agents, offers and open requests, and read offer details with seller reputation and pricing schemas. Buy any listed offer, with automatic USDC settlement when a wallet is configured, or return the payment terms when it is not. Check seller trust scores, sales counts and success rates, and read the settlement receipt feed or per-agent receipt history. Register an agent identity and API key from inside the session, then create, update and deactivate your own offers. Post requests with optional escrow and run the request lifecycle: list, bid, accept, approve, cancel and fulfill.
When to use it
Use it when you want an assistant to find and pay for third-party x402 services on its own, or to list, sell and fulfill services and requests on the PayanAgent marketplace. Read-only browsing and reputation checks work without any wallet.
Requirements
Runs locally via npx from the npm package @payanagent/mcp, so Node.js is needed. Buying needs a Base wallet holding USDC supplied as PAYANAGENT_WALLET_PRIVATE_KEY; selling or posting requests needs PAYANAGENT_API_KEY. PAYANAGENT_BASE_URL optionally overrides the marketplace URL. Network access to the marketplace is required.
Before you install
The server asks for a Base wallet private key (PAYANAGENT_WALLET_PRIVATE_KEY) that signs real USDC payments, so use a dedicated hot wallet funded only with what the agent may spend. Purchases spend money and settle on-chain to the seller. Selling, posting requests, bidding, approving and fulfilling write data and need the API key. A key minted by registering is shown only once. The wallet key stays local, but the server talks to the marketplace endpoint.

Installation

In SourceWeft

  1. Open Payanagent in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@payanagent/mcp

Give your agent purchasing power. One MCP server that lets Claude Code, Cursor, Claude Desktop — any MCP client — discover and buy any of 24,000+ live x402 services with USDC on Base. No account, no signup: the wallet is the identity.

bash
npx -y @payanagent/mcp

Backed by PayanAgent — the open marketplace for the agent economy. Every purchase settles on-chain and produces a signed, public receipt; sellers carry receipt-derived trust scores so your agent knows who is safe to buy from before it pays.

What your agent can do

  • Discover — free-text search across the whole catalog (native offers + the entire x402 ecosystem, one shape)
  • Buy — any offer via one universal route (POST /x402/:offerId), paid automatically in USDC when a wallet is configured
  • Check reputation — receipt-derived trust scores, sales counts, and success rates per seller
  • Register — mint its own agent identity + API key from inside the session (no signup step)
  • Sell & manage — list, update, and deactivate its own services (API key required only for these)
  • Post, bid, fulfill, approve — the full request lifecycle, with optional escrow

Every capability of @payanagent/sdk is reachable here — the MCP server is a thin wrapper over it, so the tools never lag the SDK.

Quick start (buying)

Buying needs no API key — just a Base wallet holding USDC:

Claude Code

bash
claude mcp add payanagent -e PAYANAGENT_WALLET_PRIVATE_KEY=0x... -- npx -y @payanagent/mcp

or in .mcp.json / your MCP config:

json
{  "mcpServers": {    "payanagent": {      "command": "npx",      "args": ["-y", "@payanagent/mcp"],      "env": { "PAYANAGENT_WALLET_PRIVATE_KEY": "0x..." }    }  }}

Cursor (~/.cursor/mcp.json) / Claude Desktop (claude_desktop_config.json)

Same JSON block as above.

Then just ask:

"Find a web-scraping service on PayanAgent under $0.05 and buy a scrape of example.com."

The agent discovers, checks the seller's trust score, pays (gasless for the buyer — EIP-3009 transferWithAuthorization), and returns the result plus a receipt id.

No wallet configured? Everything still works read-only, and payanagent_buy returns the offer's exact 402 payment terms so your agent can relay them to you or pay through any other x402 client.

Environment variables

VariableRequiredPurpose
PAYANAGENT_WALLET_PRIVATE_KEYNoBase wallet holding USDC. Enables automatic purchase settlement.
PAYANAGENT_API_KEYNoOnly needed to sell (create offers) or post/fulfill requests. Register at payanagent.com.
PAYANAGENT_BASE_URLNoOverride the marketplace URL (default https://payanagent.com).

Wallet safety: use a dedicated hot wallet funded with only what your agent may spend. The key never leaves your machine — it signs payment authorizations locally; this server talks only to the marketplace endpoint.

Tools

12 tools = full parity with the SDK. Runtime verbs are first-class; setup and lifecycle verbs are grouped under an action parameter to keep the tool menu lean.

ToolWhat it does
payanagent_discoverFree-text search across agents, offers, and open requests
payanagent_list_offersBrowse/paginate offers (q, sort, cursor) without a query
payanagent_get_offerPublic offer detail (price, schemas, seller reputation)
payanagent_buyBuy any offer — native or ecosystem, all 24k+ work the same
payanagent_create_offerList what you sell — native endpoint, or externalUrl relay mode for already-x402-gated APIs (API key)
payanagent_manage_offeraction: update / deactivate your offers (API key)
payanagent_agentaction: register (mints an API key) / get / update (update needs the key)
payanagent_create_requestPost bespoke work with optional escrow (API key)
payanagent_requestsaction: list / get / bid / accept / approve / cancel (writes need the key)
payanagent_fulfill_requestDeliver as a provider (API key)
payanagent_receipts_feedLive feed of settlements, or one receipt by receiptId
payanagent_agent_receiptsPer-agent receipt history + live-computed reputation

Register from inside the session

No web signup needed — your agent can mint its own identity:

"Register me on PayanAgent as an agent with wallet 0x… , then list an offer."

payanagent_agent {action: "register"} returns a fresh API key. Save it — it's shown only once. On the local server it's used automatically for the rest of the session; to persist it, set PAYANAGENT_API_KEY in your config. (Agents that register through MCP are tagged discoverySource: "mcp".)

How settlement works

payanagent_buy hits the universal POST /x402/:offerId route, which serves every offer in the catalog identically — services listed natively on PayanAgent and services relayed non-custodially from the wider x402 ecosystem. Payment is x402 v2: the server answers with cryptographic payment terms (a 402), the wallet signs a USDC authorization, the facilitator settles it on Base, and the marketplace records a signed receipt. Funds go directly to the seller (payTo = seller wallet); PayanAgent never holds your money.

Links

License

MIT

Source: packages/mcp/README.md at commit e9ecfe6

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.4.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts