InvoiceBloom

io.github.theasteve由 GitHub 账号 theasteve 发布v1.0.0更新于 Oct 24, 2026

Create, send and track invoices for freelancers and small businesses.

发布方自己的服务:Bloom

已验证Streamable HTTP可网页运行金融沟通与协作商业与电商

概览

AI 生成的概览

托管式发票 MCP 服务器,让助手为自由职业者或小微企业创建、发送和跟踪发票、管理客户并记录收款。

可以做什么
读取当前账户资料、邮箱确认与银行卡收款状态,以及客户和发票数量。查找、创建和更新客户,可按姓名、邮箱或公司搜索。列出并查看发票,可按状态、客户或逾期筛选,含明细、合计和公开链接。创建和更新草稿发票,含明细、税费和滞纳金,合计由服务器计算。将发票 PDF 通过邮件发送给客户,启用银行卡收款时附带 Stripe 付款链接。将线下收到的款项标记为已付,或永久删除发票。
适用场景
适合在 MCP 客户端中以对话方式起草、发送和跟进发票,而不必打开网页应用,例如询问哪些发票已逾期,或按工时给客户开票。
运行要求
远程 Streamable HTTP 端点,无需安装。需要免费的 InvoiceBloom 账户,以及在 Settings › Security 生成的 bearer API 令牌,通过 Authorization 请求头发送。发送发票前账户邮箱必须已验证。每个令牌每分钟限 120 次请求。
安装前请注意
令牌拥有与账户相同的权限,应视为机密,泄露后立即撤销。send_invoice 会向真实收件人发送邮件,并可能附带 Stripe 付款链接,调用前请确认。delete_invoice 为永久删除且无法恢复。update_invoice 传入 line_items 会替换全部现有明细。客户姓名、邮箱和发票数据会发送至 InvoiceBloom。

安装

在 SourceWeft 中

  1. 打开 控制台中的 InvoiceBloom,将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.theasteve%2Finvoicebloom/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "invoicebloom": {
      "type": "http",
      "url": "https://invoicebloom.io/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

InvoiceBloom MCP server

Create, send and track invoices from Claude, Cursor, or any Model Context Protocol client.

InvoiceBloom is a free invoicing app for freelancers and small businesses. Its MCP server is hosted: there is nothing to install or run. Point your client at the endpoint with an API token and start invoicing.

Quick start

Claude Code

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

Cursor, Windsurf and other HTTP-capable clients

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

Claude Desktop (via mcp-remote)

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

Then ask things like "Invoice Acme for 12 hours of consulting at $150 and send it" or "Which invoices are overdue?".

Tools

ToolWhat it does
get_accountYour business details, email-confirmation and payment status
list_clients / create_client / update_clientFind or add the people you invoice
list_invoices / get_invoiceFilter by status, client or overdue; full detail with line items and a shareable link
create_invoice / update_invoiceDraft invoices with line items, tax and late fees; totals are computed server-side
send_invoiceEmails the PDF to the client, with a Stripe payment link if connected
mark_invoice_paidRecord a payment received outside the app
delete_invoiceRemove an invoice

send_invoice and delete_invoice carry MCP annotations (openWorldHint, destructiveHint) so well-behaved assistants confirm with you before calling them.

Safety and limits

  • A token has the same rights as your account. Revoke it from Settings › Security the moment you think it leaked.
  • 120 requests per minute per token.
  • The same anti-abuse rules as the web app apply to sending: a confirmed email, at least one line item, and a daily send cap.
  • Unauthenticated requests get a JSON 401.

Registry metadata

server.json follows the official MCP Registry schema for remote servers.

Support

Questions or a client you want supported: https://invoicebloom.io/contact

来源:README.md,提交 1436e58

工具

11

get_account

Returns the signed-in user's profile: business name, address, saved payment instructions, whether their email is confirmed (required before sending invoices), whether they can take card payments, and client/invoice counts. Call this first to know who you are acting for.

无需输入参数。

list_clients

Lists the user's clients (people or companies they invoice), optionally filtered by a search term matched against name, email and company. Use it to find a client_id before creating an invoice.

输入参数query

create_client

Creates a new client to invoice. Name and email are required; the email is where invoices are sent. Check list_clients first so you do not create duplicates.

输入参数name必填email必填notesphoneaddresscompany_name

update_client

Updates an existing client's details. Only the fields you pass are changed.

输入参数nameemailnotesphonestatusaddressclient_id必填company_name

list_invoices

Lists the user's invoices, newest first, without line items. Filter by status (draft, sent, paid), by client, or overdue_only for unpaid invoices past their due date (there is no 'overdue' status; use overdue_only). Use get_invoice for full detail.

输入参数limitstatusclient_idoverdue_only

get_invoice

Returns one invoice with its line items, totals, status, the client it is for, a public_url the client can open, and a payment link if one exists.

输入参数invoice_id必填

create_invoice

Creates a draft invoice with line items for an existing client. Identify the client by client_id or client_email (must already exist; use create_client otherwise). Totals are computed server-side: subtotal + tax% + late_fee. Nothing is emailed until you call send_invoice. Returns the invoice, including its invoice_number and public_url.

输入参数taxdatetermsthemedue_datelate_feeclient_idline_items必填client_emailbusiness_namebusiness_addresspayment_instructions

update_invoice

Updates an invoice. Only fields you pass change. If you pass line_items, they REPLACE the existing line items entirely, so include every item that should remain. Works on draft and sent invoices; re-send with send_invoice if the client needs the new version.

输入参数taxdatetermsthemedue_datelate_feeclient_idinvoice_id必填line_itemsclient_emailbusiness_namebusiness_address另有 1 个

send_invoice

Emails the invoice (with a PDF attached) to the client's email address and marks it as sent. This contacts a real person: confirm with the user before calling. Requires at least one line item and a confirmed user email. If the user takes card payments, a Stripe payment link is added first.

输入参数invoice_id必填

mark_invoice_paid

Marks an invoice as paid, for payments received outside InvoiceBloom (bank transfer, cash, cheque). Card payments through the payment link are recorded automatically.

输入参数invoice_id必填

delete_invoice

Permanently deletes an invoice and its line items. Cannot be undone. Confirm with the user before calling; prefer leaving paid invoices in place for their records.

输入参数invoice_id必填

版本历史

1
  1. v1.0.0最新Sep 25, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Bloom 集成