Billogram MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.0.0更新于 Nov 8, 2026

Read invoices, customers, items and balances; create invoices, customers and items in Billogram.

发布方自己的服务:Ably MCP by usefulapi

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

概览

AI 生成的概览

面向 Billogram 计费系统的托管 MCP 服务器:读取发票、客户、商品与余额,并可创建发票、客户和商品。

可以做什么
  • 列出并获取发票,含明细、合计、状态、日期与已登记付款
  • 列出已发送、已付款或已催款等发票事件
  • 列出并获取客户,读取客户欠款余额
  • 列出并获取已保存的商品与服务,含价格、增值税与记账科目
  • 读取账户设置:公司信息、默认到期天数、币种与发票默认值
  • 创建客户、商品和发票(仅创建,不提供发送功能)
适用场景
适合让助手回答关于 Billogram 发票、客户和未结余额的问题,或在对话中起草新的客户、商品和发票,而无需打开 Billogram 后台。
运行要求
通过 URL 连接的远程端点,无需本地安装。登录使用 OAuth,登录页要求填写 Billogram 的 API User ID、API Password 并选择环境(生产或沙箱)。API 用户需在 Billogram 的公司设置、API、API 用户中创建。免费方案每月 50 次工具调用;付费方案按用户计费。
安装前请注意
服务器在其登录页索取 Billogram API 凭据并按用户保存。创建类工具会写入新记录且非幂等,重复调用会产生重复数据,创建前应确认。创建的发票不会被发送。付费方案涉及 Stripe 结账与扣费,取消后当期不退款。用量按每月调用上限计量。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Billogram MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

{
  "mcpServers": {
    "billogram-by-usefulapi": {
      "type": "http",
      "url": "https://billogram.usefulapi.io/mcp"
    }
  }
}

README

Billogram MCP by usefulapi

Use your Billogram account from Claude, Cursor, or any MCP client. Read invoices, customers, items and balances, and create invoices, customers and items. Hosted, no local install: connect with your own credentials.

Live endpoint: https://billogram.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://billogram.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http billogram https://billogram.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "billogram": {      "url": "https://billogram.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Billogram credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/billogram/

On first connect you provide your API User ID and API Password, and choose the Environment (Production or Sandbox). Create the API user in Billogram under Company Settings → API → API Users. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
billogram_list_invoicesreadList invoices
billogram_get_invoicereadGet invoice
billogram_list_invoice_eventsreadList invoice events
billogram_list_customersreadList customers
billogram_get_customerreadGet customer
billogram_get_customer_balancereadGet customer balance
billogram_list_itemsreadList items
billogram_get_itemreadGet item
billogram_get_settingsreadGet settings
billogram_create_customerwriteCreate customer
billogram_create_itemwriteCreate item
billogram_create_invoicewriteCreate invoice
billogram_usage_statusmetaUsage status (free-tier meter)
billogram_request_featuremetaRequest a missing feature
billogram_upgrademetaUpgrade to Pro or Pro+
billogram_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run billogram_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with billogram_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with billogram_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

来源:servers/billogram/README.md,提交 0be0869

工具

12

billogram_list_invoices

List invoices

List invoices (Billogram calls them billograms): invoice number, customer, dates, state, totals and remaining sum. Optional filter and sort. Use an id from the reply with billogram_get_invoice. GET /billogram.

输入参数pagepage_sizefilter_typeorder_fieldfilter_fieldfilter_valueorder_direction

billogram_get_invoice

Get invoice

Fetch one invoice with its customer, items, totals, state, dates and registered payments. GET /billogram/{id}.

输入参数id必填

billogram_list_invoice_events

List invoice events

List invoice events (the history of changes, such as sent, paid or reminded) as Billogram returns them. Optional filter and sort. GET /billogram_event.

输入参数pagepage_sizefilter_typeorder_fieldfilter_fieldfilter_valueorder_direction

billogram_list_customers

List customers

List customers with number, name, organisation and VAT number, contact, addresses and payment settings. Optional filter and sort. GET /customer.

输入参数pagepage_sizefilter_typeorder_fieldfilter_fieldfilter_valueorder_direction

billogram_get_customer

Get customer

Fetch one customer by customer number: contact, addresses, e-invoice details and payment settings. GET /customer/{customer_no}.

输入参数customer_no必填

billogram_get_customer_balance

Get customer balance

Fetch the balance of one customer by customer number (the amount they owe). GET /customer/{customer_no}/balance.

输入参数customer_no必填

billogram_list_items

List items

List saved items (products and services) with item number, title, price, VAT, unit and bookkeeping accounts. Optional filter and sort. GET /item.

输入参数pagepage_sizefilter_typeorder_fieldfilter_fieldfilter_valueorder_direction

billogram_get_item

Get item

Fetch one saved item by item number. GET /item/{item_no}.

输入参数item_no必填

billogram_get_settings

Get settings

Fetch the account settings: company details, default due days, currency and invoice defaults. GET /settings.

无需输入参数。

billogram_create_customer

Create customer

Create a customer. Only the fields you pass are set. Creates a new customer record each time (it is not idempotent). POST /customer.

输入参数cityname必填emailphoneorg_novat_nocountryzipcodecontact_namestreet_address

billogram_create_item

Create item

Create a saved item (product or service) for later invoices. Creates a new item each time (it is not idempotent). POST /item.

输入参数vat必填unit必填price必填title必填item_nodescription

billogram_create_invoice

Create invoice

Create an invoice (a Billogram billogram) for an existing customer. The invoice is created only: this server does not send it, and sending is a separate Billogram command that is not exposed. Creates a new invoice each time (it is not idempotent). POST /billogram.

输入参数items必填currencydue_datedue_dayscustomer_no必填invoice_date

版本历史

1
  1. v1.0.0最新Nov 8, 2026

评分

已满足适用检查项的 100%

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

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

其他 Usefulapi 集成