Docs / Agents

Agents

More money is now managed by AI agents. Floor lets an agent buy protection for the person it works for.

How an agent uses Floor

FIG. 10 / HOW AN AGENT USES FLOOR

Your agent

Any MCP client

  • Claude, ChatGPT, OpenClaw
  • its own wallet signs

Floor MCP server

Streamable HTTP

  • quote_protection
  • build_create_position_tx
  • get_status, backtest

x402 facilitator

Floor self facilitator (b402 optional)

  • verifies the signed payment
  • settles on BSC
  • b402: supported + verify live

Keeper

EOA; Agentic Wallet optional

  • rebalance(swap)
  • cannot withdraw
  • cannot set prices

Floor vault

One contract per position

  • holds user funds
  • CPPI, m = 4
  • owner can always exit

PancakeSwap

BSC tokenized-stock liquidity

  • spot swaps only
  • stock for USDT and back

User funds stay in the vault contract, never in the keeper wallet. x402 payments cover Floor API calls. It does not pay for LLM inference.

Keeper EOA primary

An automated keeper triggers rebalances. An EOA keeper is the primary one; a Binance Agentic Wallet is an optional second keeper and is not set up. Neither can move your funds. Your funds stay in your own vault contract. Your own Agentic Wallet can sign deposits and pay b402. Roles are described on Contracts.

Honest note

The Agentic Wallet keeper depends on Developer Mode and is not set up. A plain wallet is the main keeper, so rebalances never depend on it.

MCP server live

Floor exposes its actions as MCP tools: quote_protection, build_create_position_tx, build_exit_tx, get_status, backtest. Any MCP-capable agent can use them. Tools that change state return an unsigned transaction. Floor never signs.

The full tool list, inputs, prices, connection examples and a sample keeper log are on the agent reference page.

An MCP callExample
// Example request to the hosted MCP server (Streamable HTTP).
POST https://floor-server-wb4i.onrender.com/mcp
{
  "method": "tools/call",
  "params": {
    "name": "quote_protection",
    "arguments": {
      "assets": [{ "symbol": "NVDAB", "weightBps": 10000 }],
      "depositUsd": 10000,
      "floorPct": 90,
      "termDays": 365
    }
  }
}
// First reply: HTTP 402 with the price.
// Sign it with your wallet, retry, get the quote.

Pay per call with x402 live: own facilitator

quote_protection, backtest and simulate_gap each cost 0.01 USD per call, paid in USD1 or U on BSC. The free tools stay free. Buyers need no account. Payments settle through Floor's own x402 facilitator today: our server verifies the signed payment and sends the transfer itself. That path is tested end to end on a local fork with a test token.

b402 is Binance's x402 facilitator on BSC (gas sponsored). It is wired in, and our server calls it with a Binance Web3 API key that has the B402 Payments permission. Its supported and verify calls have been run live and passed. Settle has not been run live yet, so b402 is not the live path. Payments cover calls to Floor's API, not LLM inference. More on the reference page.

Agent skill in the repo

A Floor skill so a user's own agent can deposit and withdraw with the user's own wallet. It tells the agent to read the factory address from get_floor_info and check every unsigned transaction against it before signing.

Next: Contracts.