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: 
node --version  # should print v18.x or higher

​
Step 1 — Install the Float MCP

Register Float as an MCP server so your agents can call Float tools natively inside Claude Code: 
claude mcp add float -- npx -y @usefloat/mcp@latest
Add the following to .cursor/mcp.json (Cursor) or your IDE’s MCP config:
{
  "mcpServers": {
    "float": {
      "command": "npx",
      "args": ["-y", "@usefloat/mcp@latest"]
    }
  }
}
Run the Float CLI to link this machine to your Float account: 
npx @usefloat/cli@latest init
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: 
npx @usefloat/cli@latest status
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): 
claude
Then ask: 
Check my Float balance
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.