API, SMM tools and AI agents

Everything the website does, from code — the REST API, the SMM-compatible endpoint, the MCP server for agents, keys and their safety rails.

Everything the Spoofy website does, a program or an AI agent can do — same catalog, same prices, same balance. Full reference: Developers.

Three ways in

ForWhere
REST APIyour own codehttps://spoofy.social/api/v1 — JSON, OpenAPI 3.1 at /api/v1/openapi.json
SMM-compatible endpointSMM tools that already speak the standard key + action formathttps://spoofy.social/api/v2 — actions services, add, status, refill, cancel, balance
MCP serverAI agents (Claude, Cursor, VS Code and any MCP client)https://spoofy.social/mcp — Streamable HTTP

Browsing the catalog, checking a link and getting a quote need no key. A TypeScript SDK (@fimi/sdk) wraps the REST API.

API keys

  • Create and revoke keys in your dashboard under Developers. The full key (it starts with fimi_live_) is shown once.
  • Send it as Authorization: Bearer fimi_live_….
  • Up to 20 active keys per account. Keys can only be made from the signed-in dashboard: a key can't create keys or manage webhooks.

Safety rails for every key

  • Read-only keys can browse, quote and read orders, but never spend.
  • Daily cap (per UTC day, net of refunds) and per-order cap, in US dollars.
  • Platform allow-list — e.g. only X and TikTok.
  • Dry runs — "dry_run": true checks and prices an order and charges nothing.
  • Idempotency — send an Idempotency-Key with every order; a retry returns the first order, never a second charge.
  • Orders made with a key are labelled with it in the dashboard. No key can withdraw money.

Several orders at once

POST /api/v1/orders/batch takes up to 25 orders and pays for them together: every one is checked first, and if any one can't go, none is placed and each says why. The website's cart and your saved links are in the API too (/api/v1/cart, /api/v1/links/saved), so an agent can fill a cart for you to check and pay.

AI agents

The MCP tools: find_services, get_quote, place_order, place_orders (several at once), get_order, list_orders, request_refill, cancel_order, get_balance and get_top_up_info. place_order and place_orders never charge unless the agent passes confirm: true after you agreed to the price. Install lines for each client are on Developers.

Machine-readable docs

/llms.txt, /llms-full.txt (all the developer docs and this help center in one file) and the OpenAPI document.

Didn’t answer it?

Ask the chat — it can also check your own orders when you’re signed in.