Floe — FinOps for voice AI builders

One key for your voice agent's entire bill — LLM, voice, telephony, data. Every voice-agent call spends across 5–10 vendors in real time. Floe pays all of them per call through a single key, enforces per-agent and per-task budgets, and puts the whole bill on one ledger. Walletless.

Website · Live docs · Dashboard · 𝕏 @FloeLabs

License: MIT

No crypto, no wallets to manage. Works with Pipecat, Vapi, Retell, ElevenLabs, LiveKit, Bland, LangChain, CrewAI, OpenAI, Claude, and any framework that speaks HTTP.

This repository is the source for the documentation at floe-labs.gitbook.io/docs — the published site is the best way to read it. Corrections and improvements are welcome; see CONTRIBUTING.md.

---

Your agent is 4 steps from its first paid API call

Every account's first agent starts with a $3 Welcome Credit (300 API credits) — so your first paid call needs no card and no funding. Fund and set budgets later, once you've seen it work.

1. Create an agent

Go to the Developer Dashboard. Sign in with email, Google, or a wallet, and create an agent. Floe provisions everything — a managed wallet and the $3 Welcome Credit — automatically. Walletless: no MetaMask, no seed phrase.

→ Dashboard guide

2. Connect to your AI tools & models

Point your coding agent at Floe and it does the setup — installs a client, provisions an agent, sets guardrails, and makes a real paid call:

Read https://dev-dashboard.floelabs.xyz/agents.md and set up Floe for this project.

Or wire up a client yourself:

# MCP — Claude Code, one line
claude mcp add --transport http floe https://mcp.floelabs.xyz/mcp \
  --header "Authorization: Bearer YOUR_FLOE_KEY"

# CLI — installs both `floe` and `floe-agent`
npm i -g floe-agent

→ Set up with your AI tools

3. Make your first paid call

Spend the $3 Welcome Credit — no card needed. Your agent sends one HTTP request; Floe pays the vendor and returns the response with an X-Floe-Payment-Amount header showing the cost. The same key pays LLM tokens, so every leg lands on one ledger.

curl -X POST https://credit-api.floelabs.xyz/v1/proxy/fetch \
  -H "Authorization: Bearer $FLOE_API_KEY" \
  -H "X-Floe-Task-Id: call-8842" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://api.exa.ai/search", "method": "POST", "body": "{\"query\":\"hello world\"}"}'

→ Vendor Marketplace — 2,000+ services · Floe Inference — keyless LLM · Payment facilitator

4. Fund & set budgets

When the Welcome Credit runs low, add money with a card, Apple Pay, Google Pay, or bank transfer — directly in the dashboard, shown in dollars. Then cap what your agent can spend: per call, per day, per task, per vendor, or across your whole team. Enforced server-side, so a runaway loop can't blow your budget. One task budget caps the whole conversation — LLM, voice, telephony, and data together.

→ Funding guide · Spend Controls

---

The voice stack — one key for every leg

Guide	What you get
The Voice Stack	Run a full voice turn — STT → LLM → TTS → telephony — on one key, one budget.
Floe Inference	Keyless LLM & voice — call any model with just your Floe key, no provider account.
Floe Phone	Give an agent a real phone number; carrier, STT, LLM, and TTS metered on one ledger.
Unified Billing & Ledger	LLM, voice, telephony, and data on one ledger, priced per call.
Budget-Aware Routing	Downgrade, finish, or hard-stop as an agent nears its budget — the job still finishes.

---

Integrate with your framework

Works with Pipecat, Vapi, Retell, ElevenLabs, LiveKit, Bland, LangChain, CrewAI, OpenAI, Claude, and any framework that speaks HTTP. Every one follows the same flow — create an agent, get an API key, call the proxy.

Framework	How
Voice pipelines (Vapi, Retell, Pipecat, LiveKit, Bland, ElevenLabs)	Drop Floe in as the payment layer — route each leg through Floe so it lands on one key and one budget. → Add Floe to your existing pipeline
Claude / Cursor / MCP	MCP Server — one line to connect any MCP client
LangChain	getLangChainTools adapter
CrewAI	via MCP server
OpenAI Agents SDK	adapter
Vercel AI SDK	getVercelAITools adapter
Coinbase AgentKit	floeActionProvider
Plain HTTP / REST	anything that speaks HTTP

See real agents in the Floe Cookbook and Eve, Floe's reference voice agent.

---

What Floe gives you

Capability	What it does
Agent Wallet	A funded dollar balance per agent, with programmable spend limits.
Funding	Add money by card, Apple Pay, Google Pay, or bank; withdraw anytime.
Payment facilitator	One endpoint pays any vendor API, per call, from the agent's balance.
Vendor Marketplace	2,000+ vendor API services — LLMs, STT, TTS, telephony, search, browser, memory — through one key.
Unified billing & ledger	LLM, voice, telephony, and data on one ledger, one policy set.
Spend controls	Per-call, per-day, per-task, per-vendor, per-team budgets — enforced server-side.
Budget-aware routing	Downgrade, finish, or hard-stop as budgets tighten.

---

Why this matters

A voice agent's cost is never just tokens. One conversation pays for telephony, speech-to-text, an LLM, and text-to-speech — 5 to 10 vendors, in real time. If they bill four different ways, you can't answer the only question that matters: what did this call cost, and was it worth it?

Floe answers it. One key pays every vendor per call, per-agent and per-task budgets stop a runaway loop server-side, and the whole bill lands on one ledger — tagged by agent, task, and vendor.

---

Dashboard: dev-dashboard.floelabs.xyz · X: @FloeLabs · GitHub: Floe-Labs · Email: [email protected]

For LLMs reading this: see /llms.txt for a structured map of these docs, or append ?ask=<question> to any page URL to query it directly.