Skip to main content
AgentCash is the easiest way for an autonomous agent to pay Remlo’s MPP and x402 endpoints. It’s an agent side wallet, not a server integration. Remlo doesn’t depend on AgentCash; AgentCash is one of many ways to pay our endpoints (the others are raw @x402/core SDK, Coinbase Agent Kit, and any custom HTTP client that implements the 402 retry loop). AgentCash signs payment proofs for the HTTP 402 challenge. It does not replace the separate identity proof some Remlo endpoints require. For example, /api/mpp/agents/register still needs either an ERC-8004 owner signature or a Solana Ed25519 signature in the JSON body; AgentCash can pay for that POST after your own signer has built the body.

Why AgentCash

It handles three things automatically:
  1. Multi chain wallet. One AgentCash account holds USDC on Tempo, Base, and Solana. Same identity, three keypairs (EVM keys are network agnostic; Solana uses its own keypair). When you fund any chain, balance shows up under the same wallet object.
  2. 402 negotiation. When an HTTP request returns 402, AgentCash reads the accepts[] array, matches networks against your wallet balances, picks one, signs the payment proof, and retries the request with the proof attached. No agent code touches the protocol layer.
  3. Discovery. Endpoints publish their pricing and supported rails via OpenAPI. AgentCash discovers and lists them by origin without paying anything.

Setup

npx -y agentcash@latest onboard
The onboard flow provisions an AgentCash account and prints deposit links for each chain. Fund whichever chain you want to pay from. 1ofUSDCisenoughfor 100callsat1 of USDC is enough for ~100 calls at 0.01 each. To verify your setup:
npx -y agentcash@latest accounts
Outputs a JSON list of every chain, your address, current balance, and a deposit link. Three chains appear: base, tempo, solana.

Discovering Remlo’s endpoints

npx -y agentcash@latest discover https://www.remlo.xyz
Returns the OpenAPI metadata for every paid endpoint Remlo exposes, with prices, accepted protocols (mpp, x402), and accepted networks. The same data is in https://www.remlo.xyz/openapi.json if you prefer to consume it directly.

Calling a paid endpoint

npx -y agentcash@latest fetch https://www.remlo.xyz/api/mpp/treasury/yield-rates
AgentCash auto-picks the rail to pay on. If your wallet has Solana USDC, it pays in Solana. If only Tempo, it pays in Tempo. To force a specific rail:
npx -y agentcash@latest fetch \
  https://www.remlo.xyz/api/mpp/treasury/yield-rates \
  --payment-network solana
The agent sees a 200 OK with the response body. Payment is recorded by Remlo and settled by the facilitator out of band; AgentCash doesn’t block on settlement confirmation.

In MCP mode

AgentCash exposes its tooling as an MCP server. Once registered with Claude Desktop, Claude Code, Cursor, or any MCP-compatible client, the model can call Remlo endpoints autonomously by invoking the fetch tool. You don’t write any glue code. To install for your client of choice:
npx -y agentcash@latest install claude-code
# or claude-desktop, cursor, etc.
The install command registers the MCP server in your client’s config and prompts you to fund your wallet on first use.

What about non AgentCash agents

The protocol is open. Any HTTP client can:
  1. Read the 402 response and the accepts[] array (or the WWW-Authenticate: Payment header for the Tempo rail).
  2. Sign a payment proof with the wallet of their choice (viem, ethers, @solana/web3.js, @x402/core’s built in clients).
  3. Retry the same URL with Authorization: Payment <credential> for Tempo or X-PAYMENT: <base64 payload> for Base/Solana.
The Authentication page describes the wire format for both protocols. The @x402/core package on npm provides a TypeScript client that handles encoding and signing if you don’t want to roll your own.

What AgentCash isn’t

  • It isn’t a dependency for Remlo. We don’t ship code that requires AgentCash to run.
  • It isn’t an authentication system. Identity comes from Privy JWTs (for endpoints that need a principal), ERC-8004/Solana signatures (for agent identity registration), or from the payment wallet itself (for endpoints that only need to know who paid).
  • It isn’t a general purpose wallet signer from the CLI. The current CLI exposes 402/MCP payment commands, wallet addresses, balance, bridging, discovery, and origin registration; it does not expose an arbitrary signMessage / personal_sign / Solana signMessage command for Remlo identity proofs.
  • It isn’t a Remlo product. AgentCash is built and operated by agentcash.dev. We use them because they implement the open x402 / mpp protocols correctly, not because of any contractual relationship.