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 整合