Skip to main content

​
Prerequisites

  • Node.js 18 or higher (download)
  • Claude Code, Cursor, or Codex
  • A Google, Apple, email, or Solana wallet (Phantom / Solflare)
Verify Node.js is ready:

​
Step 1 — Install the Float MCP

Register Float as an MCP server so your agents can call Float tools natively inside Claude Code:
Add the following to .cursor/mcp.json (Cursor) or your IDE’s MCP config:
Run the Float CLI to link this machine to your Float account:
This opens your browser to the Float link page. Sign in with Google, Apple, email, or a Solana wallet. After sign-in, Float:
  • Creates an agent wallet on Solana
  • Writes ~/.float/config.json with your agent credentials
  • Prints your agent ID and wallet address
Confirm the link worked:
Expected output: your agent ID, Solana wallet address, and current balance.

​
Step 3 — Load USDC

Go to app.usefloat.xyz/fund and deposit USDC into your treasury. You only do this once — all your agents draw from this shared balance automatically.
Fiat on-ramp (credit card → USDC) is available on the fund page via Privy. Minimum recommended deposit: $10 to start.

​
Step 4 — Test it

Start a new Claude Code session (Float MCP must be active):
Then ask:
Float will respond with your balance, agent ID, and a list of available paid services your agent can call.

​
You’re done

Your agent can now pay for any x402-compatible API automatically — without stopping, without hitting a paywall, without asking you for a key.

MCP tools reference

See every tool available to your agent via Float MCP.

Set spending limits

Configure daily budgets and per-payment limits in the dashboard.