InvoiceBloom

npx add-mcp 'https://invoicebloom.io/mcp'

Use o InvoiceBloom no Claude e em outros assistentes de IA

O InvoiceBloom oferece um servidor MCP hospedado e uma API JSON. Dê ao seu assistente um token de API e ele poderá consultar clientes, criar rascunhos de faturas, enviá-las por e-mail e informar quem ainda deve dinheiro a você. Gratuito, como o restante do aplicativo.

1. Crie um token de API

Entre (ou crie uma conta gratuita), abra Configurações › Segurança, dê um nome ao token (por exemplo, "Claude Code") e clique em Criar token. Copie-o: ele começa com ib_ e é exibido apenas uma vez. Revogue-o na mesma página sempre que quiser.

2. Conecte seu assistente (MCP)

O servidor está em https://invoicebloom.io/mcp (HTTP Streamable). Envie o token como cabeçalho de portador (bearer).

Claude Code

claude mcp add --transport http invoicebloom https://invoicebloom.io/mcp \
  --header "Authorization: Bearer ib_YOUR_TOKEN"

Depois, faça perguntas como "Fature para a Acme 12 horas de consultoria a US$ 150 e envie" ou "Quais faturas estão vencidas?".

Claude Desktop

Adicione isto a claude_desktop_config.json (Configurações › Desenvolvedor › Editar Config). Ele faz a ponte por meio de mcp-remote porque o arquivo de configuração do Desktop não pode enviar cabeçalhos por conta própria:

{
  "mcpServers": {
    "invoicebloom": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://invoicebloom.io/mcp",
               "--header", "Authorization: Bearer ib_YOUR_TOKEN"]
    }
  }
}

Cursor, Windsurf e outros clientes MCP

{
  "mcpServers": {
    "invoicebloom": {
      "url": "https://invoicebloom.io/mcp",
      "headers": { "Authorization": "Bearer ib_YOUR_TOKEN" }
    }
  }
}

Ferramentas que seu assistente recebe

get_account	Seus dados comerciais, confirmação de e-mail e status de pagamento.
list_clients / create_client / update_client	Encontre ou adicione as pessoas para quem você emite faturas.
list_invoices / get_invoice	Filtre por status, cliente ou vencimento; detalhes completos com itens de linha e um link compartilhável.
create_invoice / update_invoice	Crie rascunhos de faturas com itens de linha, impostos e multas por atraso. Os totais são calculados para você.
send_invoice	Envia o PDF por e-mail ao cliente (com link de pagamento se o Stripe estiver conectado).
mark_invoice_paid / delete_invoice	Registre um pagamento offline ou remova uma fatura.

O envio e a exclusão são sinalizados para que assistentes bem comportados confirmem com você antes. As mesmas regras antia buso do aplicativo se aplicam: e-mail confirmado, pelo menos um item de linha e um limite diário de envios.

3. Ou chame a API JSON diretamente

URL base https://invoicebloom.io/api/v1, cabeçalho Authorization: Bearer ib_YOUR_TOKEN, JSON na entrada e na saída.

GET /me	Perfil da conta.
GET /clients?q=	Liste ou pesquise clientes. POST /clients, GET|PATCH /clients/:id.
GET /invoices	Filtros: status (rascunho, enviado, pago), client_id, overdue=true para não pagos e vencidos, page.
POST /invoices	Crie um rascunho. GET|PATCH|DELETE /invoices/:id.
POST /invoices/:id/send	Envie por e-mail ao cliente.
POST /invoices/:id/mark_paid	Registre um pagamento offline.
GET /invoices/:id/pdf	Baixe o PDF.

Exemplo: criar e enviar uma fatura

curl -X POST https://invoicebloom.io/api/v1/invoices \
  -H "Authorization: Bearer ib_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice": {
      "client_email": "billing@acme.com",
      "due_date": "2026-10-25",
      "tax": 8.5,
      "line_items": [
        { "description": "Consulting", "quantity": 12, "unit": "hours", "rate": 150 }
      ]
    }
  }'

# then, using the id from the response:
curl -X POST https://invoicebloom.io/api/v1/invoices/123/send \
  -H "Authorization: Bearer ib_YOUR_TOKEN"

Limites e erros

• 120 solicitações por minuto por token. Acima disso, você recebe 429.
• Os erros retornam como {"error": "..."} com status 401, 404, 422 ou 403.
• Os valores são números, as datas são YYYY-MM-DD, tax é uma porcentagem.
• Um token tem os mesmos direitos que você. Revogue-o no momento em que suspeitar de vazamento.

Dúvidas ou um cliente que você gostaria de ter suporte? Fale conosco.