Fakturowo MCP by usefulapi

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

Read invoices, clients and products in Fakturowo; create documents and update payment status.

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

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

概览

AI 生成的概览

把助手连接到 Fakturowo 开票账户,可读取发票、客户与商品,开具单据并更新付款状态。

可以做什么
  • 列出并获取发票及其他单据,含明细行、金额、付款状态与 KSeF 编号
  • 列出并获取已保存的客户(往来单位)与商品/服务目录
  • 查询某类单据的下一个流水编号
  • 在账户上开具新单据(发票、形式发票、收据等)
  • 修改单据的付款状态,并可附带已付金额
  • 查看本月工具调用用量、提交功能请求、升级或取消套餐
适用场景
适合发票存放在 Fakturowo 的用户,让助手在对话中查询单据、客户或商品信息,或直接开票并标记付款,而不必打开网页后台。
运行要求
远程 MCP 端点,无需本地运行环境。通过 OAuth 登录,登录页会要求填写 Fakturowo 凭据;README 说明不要在客户端配置中添加 Authorization 头或 API 密钥。Fakturowo 的 API 访问需要厂商的付费附加组件。免费额度为每月 50 次工具调用,付费套餐通过 Stripe 结算。
安装前请注意
有两个工具会写入真实账户:创建单据会立即保存、占用下一个编号,且本服务器无法删除,重复调用会开出两张单据;修改付款状态会直接改动已保存的单据。写入前应先确认。用量按次计费,付费套餐需要花钱;重新生成 Fakturowo API 密钥会产生新的计费身份。客户记录不会返回 PESEL 或身份证号。

安装

在 SourceWeft 中

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

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

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

README

Fakturowo MCP by usefulapi

Live endpoint: https://fakturowo.usefulapi.io/mcp

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://fakturowo.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http fakturowo https://fakturowo.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": {    "fakturowo": {      "url": "https://fakturowo.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 Fakturowo credentials.

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

Connect with your Fakturowo API key from Konto and, if needed, the account-specific API URL shown there. API access requires the vendor’s paid add-on. Issuing a document creates it immediately; payment changes affect the saved document. Regenerating the API key creates a new usefulapi billing identity.

Tools

ToolTypeWhat it does
fakturowo_list_documentsreadList documents
fakturowo_get_documentreadGet document
fakturowo_get_next_document_numberreadGet next document number
fakturowo_list_clientsreadList clients
fakturowo_get_clientreadGet client
fakturowo_list_productsreadList products
fakturowo_get_productreadGet product
fakturowo_create_documentwriteCreate document
fakturowo_set_document_payment_statuswriteSet document payment status
fakturowo_usage_statusmetaUsage status (free-tier meter)
fakturowo_request_featuremetaRequest a missing feature
fakturowo_upgrademetaUpgrade to Pro or Pro+
fakturowo_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 API key)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with fakturowo_upgrade (it returns a Stripe Checkout link). Cancel any time with fakturowo_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running fakturowo_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

来源:servers/fakturowo/README.md,提交 4046075

工具

9

fakturowo_list_documents

List documents

List invoices and other documents on the account, 100 per page: id (api_numer), type, number, issue and sale date, currency, net/VAT/gross value, seller and buyer, payment status, due date and KSeF number. Filter by document type or by seller/buyer tax number. Values are the vendor's own (dates DD-MM-YYYY; dokument_rodzaj is the type code with a readable name for common types). Fakturowo api_zadanie=3.

输入参数pagebuyer_tax_iddocument_typeseller_tax_id

fakturowo_get_document

Get document

One document by its id (api_numer, from fakturowo_list_documents or the id returned when it was created): the header fields and every line item (name, unit, quantity, net/gross price, discount, VAT rate and amount, gross value). Fakturowo api_zadanie=3 with api_numer.

输入参数document_id必填

fakturowo_get_next_document_number

Get next document number

The running number Fakturowo will give the next document of a type (the sequence counter saved on the account). Nothing is created. Fakturowo api_zadanie=8.

输入参数document_type

fakturowo_list_clients

List clients

List the saved clients (contractors), 100 per page: id (api_numer), name, address, tax number, contact details, account number and notes. PESEL and ID-card numbers are never returned. Fakturowo api_zadanie=4.

输入参数page

fakturowo_get_client

Get client

One saved client by id (api_numer, from fakturowo_list_clients). PESEL and ID-card numbers are never returned. Fakturowo api_zadanie=4 with api_numer.

输入参数client_id必填

fakturowo_list_products

List products

List the saved products and services (the catalogue used on documents), 100 per page: id (api_numer), name, unit, VAT rate, net price, gross value, currency, comment, GTU code and discount. Fakturowo api_zadanie=6.

输入参数page

fakturowo_get_product

Get product

One saved product by id (api_numer, from fakturowo_list_products). Fakturowo api_zadanie=6 with api_numer.

输入参数product_id必填

fakturowo_create_document

Create document

WRITE: issue a new document (invoice, proforma, receipt...) on the account. It is saved immediately and takes the next number in its sequence; this tool cannot delete it again, and calling it twice issues two documents. Issue documents one at a time and wait for each reply: Fakturowo says overlapping saves can get the same number when the account's numbering check is off. Needs a buyer and at least one line item; the seller defaults to what the account has saved only if Fakturowo allows that, otherwise pass seller. Returns the new document's id (api_numer); with public_links true also a public PDF and preview link (anyone with the link can open the document). Fakturowo api_zadanie=1.

输入参数buyer必填items必填notesplacesellercurrencysale_dateissue_datepaid_amountpayment_typepublic_linksdocument_type另有 1 个

fakturowo_set_document_payment_status

Set document payment status

WRITE: change the payment status of an existing document (unpaid, paid, partially_paid) and optionally the amount already paid. Only those fields are sent; Fakturowo edits the document in place. Fakturowo api_zadanie=1 with api_numer.

输入参数status必填document_id必填paid_amount

版本历史

11
  1. v1.11.3最新Nov 7, 2026
  2. v1.10.3Nov 5, 2026
  3. v1.10.2Nov 5, 2026
  4. v1.10.1Nov 4, 2026
  5. v1.10.0Nov 3, 2026
  6. v1.9.1Nov 3, 2026
  7. v1.8.0Nov 1, 2026
  8. v1.6.0Oct 31, 2026
  9. v1.5.0Oct 31, 2026
  10. v1.4.2Oct 30, 2026
  11. v1.4.0Oct 30, 2026

评分

已满足适用检查项的 100%

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

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

其他 Usefulapi 集成