FloorFeed

Guides › Badges, Moments and achievements

Use FloorFeed Badges from your AI app

FloorFeed's AI connector lets Claude, ChatGPT and other AI apps run your games and badges in plain words: make a game, add a badge, award it, see who claimed. It can't sign or send anything: anything on chain is a request you sign on FloorFeed.

  1. Add the connector to your AI app: https://floorfeed.io/api/mcp (Settings → AI on floorfeed.io has Copy address, and floorfeed.io/mcp has the steps for each app).
  2. Sign in, choose Market + my account and tap Allow. Then on floorfeed.io, open Settings → AI and turn on Prepare trades for that app.
  3. Ask: "Draft a soulbound collection on Base called Pixel Arena." Open the link it gives you, connect your wallet and tap Deploy.
  4. Ask: "Add a game called Pixel Arena, with a badge first-win on that collection." Then "Award first-win to player-123." A new player's answer has their claim link, shown once: pass it only to that player.
  5. When the player claims, you get a request for the mint: open it and sign it in your wallet.
  6. Ask how it's going: "How's first-win doing?", "Has player-123 claimed?", "How much of my claim gas is left?"
Free claims need your server
Awards made here have no voucher, so you sign each claim's mint. For free, relayed claims, your own server signs vouchers with the SDK (Docs → Free claims). A key never goes through a chat.
What it can't do
Sign or send; claim for a player; make or read a server API key or a webhook secret; add a webhook, invite a teammate, or change your plan, gas cap or trophy case setting. It only ever works on the account that signed in, so a teammate's AI can't act for your studio.
Publishable keys
It can make and revoke them, because they aren't secret: they ship in your game build and only award badges you marked client-awardable.
Turning it off
Turn off Prepare trades in Settings → AI and new changes stop at once and unsigned requests are withdrawn. Awards it already recorded stay until you cancel them.
Limits
300 changes a day per app or link, 100 players an award call, 30 questions a minute. Your plan's limits apply as usual. Docs → From your AI app has the calls in full.

Related