Floe Working Capital
Concede a agentes de IA (Claude, Cursor, personalizados) acesso total a capital de giro para pagar recibos x402.
Documentação
@floelabs/mcp-server
O ledger de faturamento unificado para IA de voz, via MCP. Dê ao Claude Desktop, Claude Code, Cursor, CrewAI ou qualquer cliente MCP uma única chave para cada ferramenta de voz e modelo que um agente de voz usa — STT, TTS, LLM, telefonia — além de mais de 2.000 serviços de API de fornecedores, com orçamentos sobre os quais o agente pode raciocinar. Sem wallet. Sem necessidade de cripto.
Website · Docs · Dashboard · 𝕏 @FloeLabs
73 ferramentas cobrindo todo o ciclo de vida do agente — crie agentes, emita/rotacione chaves, defina orçamentos, estime custos e execute pagamentos x402 — com autenticação ciente do transporte (HTTP remoto usa um token Bearer; stdio local lê FLOE_API_KEY do ambiente) e um nível sem chave (get_markets, check_x402_url, search_floe_docs funcionam sem nenhuma chave).
Comece grátis. Um Crédito de Boas-Vindas de $3 (300 créditos de API) no cadastro — sem cartão, sem wallet. Obtenha uma chave de agente →
Comece a construir com Floe
Uma chave para toda a conta de fornecedores do seu agente — LLM, voz, telefonia, busca, dados — medida por chamada e limitada por orçamento. Deixe seu agente de codificação configurar, ou configure você mesmo:
| Caminho | Uma linha |
|---|---|
| Agente — Claude Code / Cursor faz a configuração | cole: Read https://dev-dashboard.floelabs.xyz/agents.md and set up Floe for this project. |
| Skill — instale a skill do agente Floe | npx skills add floe-labs/agent-skills |
| MCP — servidor MCP hospedado (73 ferramentas) | npx -y add-mcp https://mcp.floelabs.xyz/mcp |
| CLI — a plataforma completa do seu terminal: agentes, chaves, orçamentos, faturamento | npx @floelabs/cli init |
NPM — o SDK + CLI floe-agent | npm i -g floe-agent |
Novas contas recebem um Crédito de Boas-Vindas de $3 (300 créditos de API) — sem cartão. Configure com suas ferramentas de IA → · Obtenha uma chave →
O que torna isso diferente
A maioria das ferramentas de pagamento permite que um agente gaste. Floe permite que um agente raciocine sobre o gasto antes de se comprometer — e o impede antes de estourar o limite.
- Ferramentas de consciência do agente —
get_credit_remaining,estimate_x402_cost,get_loan_state: seu agente pergunta "tenho orçamento? essa chamada vale a pena?" antes de pagar, não depois. - Orçamentos cientes do contexto — defina um limite de gasto por sessão; o agente reduz conforme se aproxima do limite e replaneja para terminar dentro do orçamento.
- A skill do agente Floe (Floe-Labs/agent-skills) — o manual que transforma essas ferramentas em comportamento de gasto deliberado. Pule para ela ↓
- Aplicação no servidor — o sinal suave é a skill; o teto rígido é o limite de gasto on-chain + lista de permissões de comerciantes. O agente não pode gastar demais independentemente do que decidir.
Início rápido (remoto, recomendado)
Instalação em uma linha:
# Universal (any MCP-aware client)
npx -y add-mcp https://mcp.floelabs.xyz/mcp
# Claude Code
claude mcp add --transport http floe https://mcp.floelabs.xyz/mcp --header "Authorization: Bearer YOUR_FLOE_KEY"
# Codex (reads the key from $FLOE_API_KEY at connect time)
codex mcp add floe --url https://mcp.floelabs.xyz/mcp --bearer-token-env-var FLOE_API_KEY
Ou por configuração JSON:
{ "mcpServers": { "floe": {
"url": "https://mcp.floelabs.xyz/mcp",
"headers": { "Authorization": "Bearer floe_YOUR_AGENT_KEY" }
} } }
Obtenha sua chave de agente: dashboard → Criar agente → copie a chave floe_<hex>
(exibida uma vez). Ou pela CLI: npx @floelabs/cli init — cole sua chave de desenvolvedor do dashboard e ela
cria (ou seleciona) o agente e emite a chave para você. Ainda não tem chave? O servidor continua funcionando —
veja Nível sem chave.
Parâmetros de escopo — restrinja o que uma sessão pode fazer direto da URL:
https://mcp.floelabs.xyz/mcp?read_only=true # only non-mutating tools
https://mcp.floelabs.xyz/mcp?features=spend,pricing # only the named capability groups
Grupos de capacidade: lending, spend, pricing, lifecycle, observability, payments, webhooks, docs.
Ambos os parâmetros combinam. O loop de decisão da skill do agente Floe precisa de spend,pricing.
→ Stdio local, instalação global e taxonomia de chaves abaixo
Ferramentas em resumo
| Grupo | Ferramentas | Para |
|---|---|---|
| Execução de pagamento ⭐ | x402_pay (idempotente), x402_forecast, estimate_x402_cost, check_x402_url | pagar qualquer fornecedor x402 — com pré-verificação de custo primeiro |
| Ciclo de vida do agente | create_agent, list_agents, get_agent, pause_agent, resume_agent, close_agent, create_agent_key, rotate_agent_key, revoke_agent_key, set_agent_key_budget, open_credit_line, get_credit_line_bounds | inicializar e gerenciar a frota com uma chave de desenvolvedor |
| Consciência do agente ⭐ | get_credit_remaining, get_loan_state, get_spend_limit, set_spend_limit, clear_spend_limit | todo agente — raciocine sobre o custo antes de pagar |
| Governança de gastos | register_credit_threshold, list_credit_thresholds, delete_credit_threshold (webhooks) | governar + alertar sobre utilização |
| Lista de permissões de comerciantes | set_allowlist_mode, get_allowlist_mode, add_allowlist_entry, remove_allowlist_entry, list_allowlist | negação por padrão sobre quais destinos o agente pode pagar |
| Financiamento e observabilidade | get_funding_instructions, get_balances, get_activity, get_usage_summary | financiar agentes + monitorar o gasto da frota |
| Webhooks | create_webhook, list_webhooks, list_webhook_events, get_webhook, update_webhook, delete_webhook, test_webhook, rotate_webhook_secret, list_webhook_deliveries, get_webhook_delivery, retry_webhook_delivery | notificações push para eventos de conta + o log de entrega |
| Docs | search_floe_docs (sem chave) | aprenda a API Floe sem sair do MCP |
| Wallet | get_wallet_balance, get_accrued_interest | saldos + estado |
| Utilitário | simulate_transaction, broadcast_transaction, get_transaction_status | ciclo de vida de transações |
| Protocolo de empréstimo (avançado) | 20+ ferramentas de intent / colateral / liquidação | empréstimos cripto-nativos contra depósitos |
A referência completa por ferramenta está em Ferramentas (73) abaixo.
Clientes testados
| Cliente | Status |
|---|---|
| Claude Desktop | GA |
| Claude Code | GA |
| Cursor | GA |
| Continue / Cline | Melhor esforço |
CrewAI (via langchain-mcp-adapters) | Beta |
| OpenAI Agents SDK | Preview (fallback MCP enquanto o adaptador nativo não chega) |
| ElizaOS | Preview |
Opções de instalação
A opção 1 (remota) está em Início rápido acima. Para execuções locais:
Local via npx
Execute o servidor localmente. Ele faz proxy de todas as solicitações para a API Floe.
FLOE_API_KEY=floe_YOUR_AGENT_KEY npx -y @floelabs/mcp-server --stdio
Configuração do Claude Desktop:
{
"mcpServers": {
"floe": {
"command": "npx",
"args": ["-y", "@floelabs/mcp-server", "--stdio"],
"env": {
"FLOE_API_KEY": "floe_YOUR_AGENT_KEY"
}
}
}
}
Configuração do Cursor (.cursor/mcp.json):
{
"mcpServers": {
"floe": {
"command": "npx",
"args": ["-y", "@floelabs/mcp-server", "--stdio"],
"env": {
"FLOE_API_KEY": "floe_YOUR_AGENT_KEY"
}
}
}
}
Instalação global
npm install -g @floelabs/mcp-server
FLOE_API_KEY=floe_YOUR_AGENT_KEY floe-mcp --stdio
Seleção de transporte
--stdio e --http são substituições explícitas. Sem nenhuma das flags, o servidor escolhe pelo
que stdin é: um pipe (um cliente MCP o iniciando) → stdio; um terminal ou o
/dev/null de um gerenciador de serviços → HTTP em 127.0.0.1:3100. Portanto, uma configuração command: npx
simples agora funciona — mas mantenha --stdio nas configurações mesmo assim para que o comportamento nunca dependa de
como o cliente conecta o stdio. Em falha de inicialização, o processo registra [floe-mcp] Fatal:
no stderr e sai com código 1; no modo stdio, todo o registro vai para o stderr, nunca
para o stdout (que carrega o protocolo MCP).
Modelo de autenticação
A fonte de autenticação depende do transporte:
| Transporte | Fonte de identidade |
|---|---|
HTTP remoto (https://mcp.floelabs.xyz/mcp) | cabeçalho Authorization: Bearer <key> (por solicitação) |
Stdio local (floe-mcp --stdio / npx -y @floelabs/mcp-server --stdio) | variável de ambiente FLOE_API_KEY |
| HTTP local (self-hosted) | cabeçalho Authorization: Bearer <key> (por solicitação). A chave de variável de ambiente nunca é usada como fallback para solicitações HTTP sem cabeçalho — solicitações sem Bearer executam sem chave. |
Nível sem chave
O servidor inicia (e o endpoint hospedado responde) sem nenhuma chave. Sessões
sem chave obtêm exatamente três ferramentas com resultados ao vivo: get_markets,
check_x402_url e search_floe_docs — o suficiente para avaliar um fornecedor, precificar uma chamada
e aprender a API antes do cadastro. Toda outra ferramenta retorna um erro estruturado:
{ "error": "AUTH_REQUIRED", "status": 401,
"message": "…Requires an agent key (floe_...).",
"next": "Get a developer key at https://dev-dashboard.floelabs.xyz, then mint agent keys with create_agent_key. …" }
Erros de ferramenta sempre carregam o status HTTP do backend (para que agentes possam distinguir
401/403/404/429), e 401/403 incluem uma dica de correção que distingue
chave ausente de tipo de chave errado.
Qual chave usar
Dois formatos de chave desbloqueiam superfícies diferentes — toda descrição de ferramenta indica qual é necessária:
| Formato de chave | Escopo | Desbloqueia |
|---|---|---|
floe_<64-hex> (chave de agente) | Um agente específico | Runtime: consciência do agente, governança de gastos, lista de permissões, reputação, estimate_x402_cost, x402_forecast e x402_pay. Uma sessão MCP = um agente. Ferramentas de ciclo de vida retornam 401 (tipo de chave errado). |
floe_live_<base62> (chave de desenvolvedor) | Conta inteira de desenvolvedor | Ciclo de vida: create_agent, chaves de agente (create_agent_key, rotate_agent_key, …), orçamentos, linhas de crédito, instruções de financiamento, saldos, atividade, uso, webhooks. Ferramentas de runtime de agente retornam 401 (tipo de chave errado). |
Bootstrap típico: conecte com a chave de desenvolvedor → create_agent →
create_agent_key → reconecte (ou abra uma segunda sessão MCP) com a chave de agente
emitida para gastar.
Obtenha uma chave de agente:
- Vá para dev-dashboard.floelabs.xyz
- Conecte sua wallet e Crie um agente (nome + limite de empréstimo + taxa máxima)
- Copie a chave
floe_<64-hex>exibida no final do assistente — ela é revelada apenas uma vez
Você também pode emitir uma pela CLI:
# Platform CLI — interactive: paste your developer key, create or select an
# agent, and the minted agent key lands in your OS keychain
# (manage agent keys later with `floe keys list|create|rotate|revoke`,
# developer keys with `floe devkeys`)
npx @floelabs/cli init
# SDK-level alternatives:
# TypeScript SDK
npx floe-agent register --name my-agent --borrow-limit 10000
# Python SDK
floe-agent register --name my-agent --borrow-limit 10000
A CLI da plataforma e este servidor MCP cobrem a mesma superfície de API. @floelabs/cli é a
plataforma completa de um terminal — agentes, chaves, orçamentos, políticas, faturamento, fundos, telefone,
chamadas medidas — com --json em todo comando e códigos de saída estáveis para scripts e CI.
MCP continua sendo a integração mais rica em contexto: ferramentas que seu agente descobre, raciocina
e chama no meio da sessão sem precisar sair para o shell.
Obtenha uma chave de desenvolvedor (desbloqueia as ferramentas de ciclo de vida — create_agent, emissão de chaves, orçamentos, financiamento, webhooks — e visibilidade multi-tenant em todos os seus agentes):
- Vá para dev-dashboard.floelabs.xyz/keys
- Clique em Criar Chave, dê um rótulo, escolha permissões
readouread_write - Copie a chave
floe_live_<base62>exibida uma única vez
Chaves de desenvolvedor abrangem toda a conta de desenvolvedor e têm um limite de taxa separado (100 req/min). Ferramentas de runtime de agente (get_credit_remaining, get_spend_limit, x402_pay, etc.) retornam 401 com uma chave de desenvolvedor porque o chamador é o desenvolvedor, não um único agente — a dica next do erro diz isso e aponta para create_agent_key. Veja a documentação de Chaves de API para a taxonomia completa.
Financie com moeda fiduciária: Você pode financiar sua wallet com USDC via Coinbase — cartão de crédito, transferência bancária, Apple Pay, Google Pay — diretamente do dashboard. Sem necessidade de on-ramp de cripto.
Múltiplos agentes
Um desenvolvedor Floe pode possuir muitos agentes. Para executar várias sessões MCP lado a lado (ex.: um agente de pesquisa e um agente de trading), emita uma chave por agente e configure cada entrada de cliente MCP com sua própria chave:
{
"mcpServers": {
"floe-research": {
"url": "https://mcp.floelabs.xyz/mcp",
"headers": { "Authorization": "Bearer floe_KEY_FOR_RESEARCH_AGENT" }
},
"floe-trading": {
"url": "https://mcp.floelabs.xyz/mcp",
"headers": { "Authorization": "Bearer floe_KEY_FOR_TRADING_AGENT" }
}
}
}
Cada sessão é limitada a um agente — linhas de crédito, limites de gasto e webhooks permanecem isolados.
Variáveis de ambiente
| Variável | Obrigatória | Padrão | Descrição |
|---|---|---|---|
FLOE_API_KEY | Não (nível sem chave sem ela) | — | Sua chave de API Floe: chave de agente floe_<64-hex> para ferramentas de runtime/gasto, chave de desenvolvedor floe_live_<base62> para ferramentas de ciclo de vida. Fonte de identidade no modo stdio; ignorada para solicitações HTTP, que autenticam por solicitação via Authorization: Bearer |
FLOE_API_BASE_URL | Não | https://credit-api.floelabs.xyz | Endpoint da API |
MCP_PORT | Não | 3100 | Porta do servidor HTTP (modo não-stdio) |
MCP_HOST | Não | 127.0.0.1 | Endereço de bind HTTP; defina 0.0.0.0 para expor além do loopback |
MCP_TRUSTED_ORIGINS | Não | — | Origens extras separadas por vírgula permitidas pelo CORS no modo HTTP |
Ferramentas (73)
Abaixo, as ferramentas estão listadas por tipo de solicitação. O resumo está em Ferramentas em resumo acima.
Toda descrição também nomeia a chave necessária: chave de agente (floe_...), chave de desenvolvedor
(floe_live_...), qualquer chave ou nenhuma. A tag de grupo de recursos em cada título é o que
?features= filtra.
Execução de pagamento (payments, pricing) ⭐
A razão pela qual todo o resto existe: estime → preveja → pague. x402_pay precisa de uma chave de agente; check_x402_url é sem chave.
| Ferramenta | Descrição |
|---|---|
x402_pay | Executa uma chamada x402 paga através do proxy Floe — paga o fornecedor em USDC a partir do saldo/crédito do agente, retorna a resposta do fornecedor + cabeçalhos de medição X-Floe-*. idempotency_key faz com que novas tentativas sejam repetidas em vez de pagar em dobro |
x402_forecast | Previsão de custo em lote + pré-verificação de política para até 50 chamadas planejadas (com contagens de repetição) — uma única ida e volta para validar um plano inteiro |
estimate_x402_cost | Pré-verificação de uma URL x402 — retorna custo e reflexão sobre seu crédito, sem pagamento |
check_x402_url | Sonda sem chave: esta URL está protegida por x402 e quanto custa? |
Ciclo de vida do agente (lifecycle) — chave de desenvolvedor
Inicialize e gerencie a frota sem tocar no painel.
| Ferramenta | Descrição |
|---|---|
create_agent | Provisiona um agente gerenciado: carteira Privy + delegação on-chain patrocinada + o crédito de boas-vindas de $3 na primeira conta do agente (uma vez por conta, imediatamente utilizável) |
list_agents | Lista todos os agentes na conta com status e limites |
get_agent | Detalhes de um agente: status, endereço de depósito, crédito usado, atividade das últimas 24h |
pause_agent | Suspende um agente (interruptor de segurança) — suas chaves falham na autenticação até serem retomadas |
resume_agent | Reativa um agente pausado |
close_agent | Encerra um agente de forma irreversível: paga empréstimos, varre fundos, desativa chaves |
create_agent_key | Emite uma chave de agente floe_... (texto simples uma vez), opcionalmente com um orçamento de gastos contínuo |
rotate_agent_key | Revoga e re-emite atomicamente uma chave (novo texto simples uma vez) |
revoke_agent_key | Exclui uma chave — chamadas que a usam falham imediatamente |
set_agent_key_budget | Define/atualiza um orçamento contínuo de falha fechada em uma chave |
open_credit_line | Atualiza um agente pré-pago para uma linha de crédito gerenciada (colateral da sua carteira) |
get_credit_line_bounds | Pré-visualiza faixas válidas de depósito/LTV antes de open_credit_line |
Financiamento e observabilidade (observability) — chave de desenvolvedor
| Ferramenta | Descrição |
|---|---|
get_funding_instructions | "Como financiar este agente" legível por máquina: endereço de depósito USDC, cadeia 8453, mínimos/avisos |
get_balances | Agrega USDC entre carteira do desenvolvedor, carteiras de agentes e créditos de API |
get_activity | Feed de atividade unificado (chamadas de proxy, onramps, transferências, empréstimos) com filtros + paginação por cursor |
get_usage_summary | Resumo de análise de gastos/uso: KPIs, séries diárias, principais endpoints |
Webhooks (webhooks) — chave de desenvolvedor
| Ferramenta | Descrição |
|---|---|
create_webhook | Registra um endpoint para eventos da conta (segredo de assinatura mostrado uma vez). Escopos: global, wallet, agent (endereço da carteira do agente), loan; eventos aceitam nomes exatos, * ou curingas de prefixo como call.* |
list_webhooks | Lista webhooks registrados (segredos nunca retornados) |
list_webhook_events | O catálogo de eventos ao vivo — 30 eventos em empréstimo / agente / crédito / chamada / telefone / marketplace |
get_webhook | Um webhook + suas estatísticas de entrega (pendente/sucesso/falha/repetindo/total) |
update_webhook | Altera URL, eventos, descrição ou pausa/retoma via active (escopo é imutável) |
delete_webhook | Exclui um endpoint permanentemente |
test_webhook | Envia uma entrega de teste assinada para verificar a conectividade de ponta a ponta |
rotate_webhook_secret | Rotaciona o segredo de assinatura (novo segredo mostrado uma vez) |
list_webhook_deliveries | Log de entrega em toda a conta com filtros (endpoint, evento, carteira do agente, status, intervalo de tempo, id de entrega/correlação) + paginação por cursor; retenção de 30 dias |
get_webhook_delivery | Uma entrega completa: payload enviado, corpo de resposta sanitizado, próximo horário de repetição |
retry_webhook_delivery | Reentrega manualmente uma entrega com falha (deduplicação em X-Floe-Delivery-Id) |
Documentação (docs) — sem chave
| Ferramenta | Descrição |
|---|---|
search_floe_docs | Pesquisa o índice de documentação do Floe (llms.txt) — títulos, URLs, descrições |
Ferramentas de leitura (lending)
| Ferramenta | Descrição |
|---|---|
get_markets | Lista mercados de empréstimo ativos com taxas e liquidez (sem chave) |
get_open_lend_intents | Navega pelas ofertas de empréstimo disponíveis para tomar emprestado |
get_open_borrow_intents | Navega pelas solicitações de empréstimo de tomadores buscando credores |
get_intent_details | Obtém detalhes completos de uma intenção específica por hash |
get_loan | Obtém detalhes do empréstimo por ID numérico |
get_user_loans | Obtém todos os empréstimos de uma carteira (tomador + credor) |
get_loan_health | Verifica LTV do empréstimo, status de saúde, risco de liquidação |
get_token_price | Preço atual do oráculo para tokens de colateral |
get_wallet_balance | Saldos de tokens de uma carteira |
get_accrued_interest | Juros acumulados em um empréstimo |
Ferramentas de escrita (lending, retornam transações não assinadas)
| Ferramenta | Descrição |
|---|---|
create_lend_intent | Cria uma oferta de empréstimo |
create_borrow_intent | Cria uma solicitação de empréstimo |
create_counter_intent | Aceita uma oferta existente (solucionador corresponde automaticamente) |
repay_loan | Paga um empréstimo com proteção contra slippage |
add_collateral | Adiciona colateral para melhorar a saúde do empréstimo |
withdraw_collateral | Retira colateral excedente |
liquidate_loan | Liquida um empréstimo não saudável |
revoke_intent | Cancela uma intenção ativa |
approve_token | Aprova gasto de tokens para o protocolo |
Ferramentas de análise (lending)
| Ferramenta | Descrição |
|---|---|
check_compatibility | Verifica se duas intenções podem corresponder |
calculate_risk | Métricas de risco: LTV, preço de liquidação, buffer |
estimate_interest | Estimativa de juros para determinados termos de empréstimo |
Ferramentas utilitárias (lending)
| Ferramenta | Descrição |
|---|---|
simulate_transaction | Executa uma transação em modo simulação (eth_call) |
broadcast_transaction | Envia uma transação assinada |
get_transaction_status | Verifica o recibo da transação |
Ferramentas de consciência do agente (spend) ⭐
Permite que um agente responda "tenho crédito?", "essa chamada vale a pena?" e "onde estou no ciclo de vida do empréstimo?" antes de comprometer capital. Todas exigem uma chave de API de agente (floe_*). A identidade da chamada é obtida do cabeçalho Bearer no modo HTTP, ou de FLOE_API_KEY no modo stdio.
| Ferramenta | Descrição |
|---|---|
get_credit_remaining | Crédito disponível atual, margem para auto-empréstimo, utilização em bps |
get_loan_state | Estado aproximado: idle | borrowing | at_limit | repaying |
get_spend_limit | Limite de gastos da sessão ativa atual, se houver |
set_spend_limit | Define um teto de USDC em nível de sessão (reinicia a janela da sessão) |
clear_spend_limit | Remove o limite de gastos da sessão |
list_credit_thresholds | Lista limites registrados de utilização de crédito |
register_credit_threshold | Registra um gatilho de webhook em um limite de utilização (máx: 20 por agente) |
delete_credit_threshold | Remove um limite registrado |
get_agent_reputation | Pontuação de crédito 0–100, faixa e multiplicador de colateral para o agente chamador |
Ferramentas de lista de permissões de comerciante (spend)
Opt-in, restrição padrão de negação sobre quais destinos o agente pode pagar. Uma entrada de lista de permissões é uma linha de política limitada comum que funciona como "permitido E limitado". Modo padrão off = permitir qualquer fornecedor (zero atrito de integração). Todas exigem uma chave de API de agente (floe_*).
| Ferramenta | Descrição |
|---|---|
set_allowlist_mode | Define a aplicação: off | host (bloquear hosts não listados pré-busca) | vendor (bloquear beneficiários não listados pré-assinatura) | both |
get_allowlist_mode | Lê o modo de aplicação atual do agente |
add_allowlist_entry | Adiciona uma entrada permitida-E-limitada — kind=api (host) ou kind=vendor (beneficiário), com um limite de gastos limit_raw |
remove_allowlist_entry | Revoga uma entrada da lista de permissões por id de política (de list_allowlist) |
list_allowlist | Lista entradas de host (api) e beneficiário (vendor) da lista de permissões com seus limites |
Ferramentas de gateway de inferência (pricing)
| Ferramenta | Descrição |
|---|---|
list_models | Catálogo de modelos compatível com OpenAI para Floe Inference (texto/embedding/TTS/STT/realtime) |
estimate_inference_cost | Precifica uma chamada de inferência a partir de um vetor de uso sem fazê-la |
Habilidade de consciência de orçamento
As habilidades de agente do Floe vivem em seu próprio repositório: Floe-Labs/agent-skills.
A habilidade floe é o manual que transforma as ferramentas MCP acima em comportamento de gasto deliberado: leia o status do orçamento antes de pagar, reduza conforme se aproxima do limite mais restrito, replaneje para terminar a tarefa dentro do orçamento e pare antes do teto. Ela lê o status das ferramentas existentes get_credit_remaining, get_spend_limit, estimate_x402_cost e get_loan_state, além do cabeçalho X-Floe-Budget-Advisory que o proxy x402 do Floe carimba nas respostas pagas — sem nova ferramenta ou backend necessário.
Sinal suave, não a salvaguarda. A habilidade ajuda um agente cooperativo a gastar com sabedoria. O teto real é aplicado no lado do servidor — a linha de crédito on-chain, o limite de gastos da sessão e (se configurado) a lista de permissões de comerciante recusam chamadas além do limite, independentemente do que o agente decidir.
Instalação:
npx skills add floe-labs/agent-skills # skills.sh CLI
# or manually:
git clone https://github.com/floe-labs/agent-skills
cp -r agent-skills/skills/floe ~/.claude/skills/ # or .claude/skills/ per-project
Fluxo de transação
Todas as ferramentas de escrita retornam transações não assinadas — o servidor nunca mantém chaves privadas.
1. Call a write tool (e.g., create_counter_intent)
→ Returns { transactions: [...], summary, warnings, expiresAt }
2. (Optional) Call simulate_transaction to dry-run
3. Sign each transaction locally with your wallet
4. Call broadcast_transaction with the signed hex
→ Returns { transactionHash, status, blockNumber }
Exemplo: Obter uma linha de crédito USDC
Agent: "I need 9,950 USDC working capital"
1. get_open_lend_intents → browse USDC/USDC offers
2. create_counter_intent(offer_hash, wallet) → unsigned txs
3. simulate_transaction(from, to, data) → { success: true, gasEstimate }
4. Sign locally → signed hex
5. broadcast_transaction(signed_hex) → confirmed
Assinatura com viem
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";
const wallet = createWalletClient({
account: privateKeyToAccount(PRIVATE_KEY),
chain: base,
transport: http(),
});
// Sign and send each transaction in order
for (const { transaction: tx } of response.transactions) {
const hash = await wallet.sendTransaction({
to: tx.to,
data: tx.data,
value: BigInt(tx.value),
});
// Wait for confirmation before next step
}
Uso programático
SDK de cliente MCP
import { Client } from "@modelcontextprotocol/sdk/client";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({ name: "my-agent" });
await client.connect(new StreamableHTTPClientTransport(
new URL("https://mcp.floelabs.xyz/mcp"),
{ requestInit: { headers: { "Authorization": "Bearer floe_..." } } }
));
const markets = await client.callTool("get_markets", {});
const counter = await client.callTool("create_counter_intent", {
offer_hash: "0x...",
wallet_address: "0x...",
});
LangChain / LangGraph
from langchain_mcp_adapters import MultiServerMCPClient
async with MultiServerMCPClient({
"floe": {"url": "https://mcp.floelabs.xyz/mcp", "headers": {"Authorization": "Bearer floe_..."}}
}) as client:
tools = client.get_tools()
# Use tools in your agent
CrewAI
Agentes CrewAI podem consumir as ferramentas MCP do Floe via langchain-mcp-adapters. Uma crew executável está disponível em floe-cookbook/crewai-demo.
Arquitetura
Your Agent → MCP Server → credit-api.floelabs.xyz → Envio Indexer / Base RPC
↑ ↑
This package Private backend
(open source) (holds secrets)
O servidor MCP é um cliente HTTP leve. Toda a lógica de protocolo, consultas de indexador e chamadas RPC acontecem no backend privado da API Floe. Este pacote contém apenas definições de ferramentas e chamadas fetch().
Protocolo de empréstimo (avançado)
Floe é a camada de gastos para agentes de IA — uma chave que paga qualquer API de fornecedor sob orçamentos programáveis (tudo acima). Ele também expõe uma camada de empréstimo avançada, nativa de cripto e baseada em intenções, na Base, para agentes que desejam capital de giro contra depósitos:
- Mercado primário (USDC/USDC): Deposite USDC como colateral, tome emprestado até 99,5% como linha de crédito. Sem risco de volatilidade de preço — mercado de mesmo token.
- Mercados voláteis: Também suporta colateral WETH e cbBTC para casos de uso nativos de cripto.
- Solucionadores correspondem automaticamente pares de intenções compatíveis on-chain.
- Empréstimos são criados com termos correspondentes, colateral bloqueado em escrow isolado por empréstimo.
- Sem gás — Floe patrocina todos os custos de transação.
- Taxas fixas — sem surpresas de taxas variáveis.
Conceitos-chave:
- Intenção: Uma oferta on-chain para emprestar ou tomar emprestado
- Contra-intenção: Uma intenção criada para corresponder a uma oferta existente
- Fator de saúde: Razão entre valor do colateral e dívida — abaixo do limite aciona liquidação
- LTV (Loan-to-Value): Dívida do tomador como % do valor do colateral
Endereços de contratos (Base Mainnet)
| Contrato | Endereço |
|---|---|
| LendingIntentMatcher | 0x17946cD3e180f82e632805e5549EC913330Bb175 |
| PriceOracle | 0xEA058a06b54dce078567f9aa4dBBE82a100210Cc |
| LendingViews | 0x9101027166bE205105a9E0c68d6F14f21f6c5003 |
| x402 Facilitator | 0x58EDdE022FFDAD3Fb0Fb0E7D51eb05AaF66a31f1 |
Links
- Site
- Painel
- Documentação
- CLI da plataforma (
@floelabs/cli) - SDK TypeScript (
floe-agent) - SDK Python (
floe-agentkit-actions) - Exemplos de ponta a ponta
Licença
MIT