Quipu MCP by usefulapi

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

Read contacts, invoices and book entries; create contacts and draft invoices in Quipu.

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

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

概览

AI 生成的概览

面向 Quipu 会计的托管 MCP 服务器:读取联系人、发票和记账分录,并可创建联系人和草稿发票。

可以做什么
  • 列出并按类型、税号、国家、邮箱或文本筛选联系人,含每个联系人的已付与未付收支合计
  • 列出并获取已开和已收发票,含合计与临时 PDF 下载链接
  • 列出记账分录(发票、票据及其他分录),可按类型、期间、状态或联系人筛选
  • 列出发票编号系列、会计分类和子分类
  • 创建联系人并更新联系人字段
  • 为联系人创建草稿收入发票
适用场景
适合让助手回答关于 Quipu 发票、未付或逾期金额、含增值税和 IRPF 预扣的季度开票额等问题,或在不打开 Quipu 应用的情况下准备客户联系人和草稿发票。
运行要求
通过 streamable HTTP 访问的远程端点,无需本地安装。使用 OAuth 登录,首次连接时需提供 Quipu API 客户端 ID 和密钥(在 Quipu 设置中获取)以及账户 slug。客户端配置中不放置密钥。超出免费额度后需要订阅方案。
安装前请注意
有三个工具会写入 Quipu 账户:创建联系人、更新联系人、创建草稿发票,执行前应确认。草稿发票不会开具或编号,需在 Quipu 中完成。Quipu API 凭据由第三方托管方按用户存储。用量受限:免费版每月 50 次调用,付费方案涉及 Stripe 付款和订阅管理工具。

安装

在 SourceWeft 中

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

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

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

README

Quipu MCP by usefulapi

Use your Quipu account from Claude, Cursor, or any MCP client. Read clients, suppliers, invoices and accounting entries, and create contacts and draft invoices. Hosted, no local install: connect with your own credentials.

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

Connect

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

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

On first connect you provide your Quipu API client ID and client secret (Quipu → Settings → API) and your account slug (the part after getquipu.com/ in your Quipu URL). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
quipu_list_contactsreadList contacts
quipu_get_contactreadGet contact
quipu_list_invoicesreadList invoices
quipu_get_invoicereadGet invoice
quipu_list_book_entriesreadList book entries
quipu_list_numbering_seriesreadList numbering series
quipu_list_accounting_categoriesreadList accounting categories
quipu_list_accounting_subcategoriesreadList accounting subcategories
quipu_create_contactwriteCreate contact
quipu_update_contactwriteUpdate contact
quipu_create_draft_invoicewriteCreate draft invoice
quipu_usage_statusmetaUsage status (free-tier meter)
quipu_request_featuremetaRequest a missing feature
quipu_upgrademetaUpgrade to Pro or Pro+
quipu_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)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 quipu_upgrade (it returns a Stripe Checkout link). Cancel any time with quipu_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running quipu_upgrade before then undoes the cancel. Or write to [email protected].

License

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

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

工具

11

quipu_list_contacts

List contacts

List contacts (clients and suppliers) of the Quipu account. Filter by kind, tax id, country, email or free text.

输入参数qkindpagesortemailtax_idcountrypage_size

quipu_get_contact

Get contact

Get one contact by id, with its totals of paid and unpaid incomes and expenses.

输入参数contact_id必填

quipu_list_invoices

List invoices

List invoices (issued and received). Filter by kind, period, operation date, payment status or contact. Totals and PDF links are in the attributes.

输入参数qkindpageperiodincludepage_sizecontact_idoperation_datepayment_statusoperation_date_tovalidation_statusoperation_date_from

quipu_get_invoice

Get invoice

Get one invoice by id. Income invoices include download_pdf_url and ephemeral_open_download_pdf_url (a temporary PDF link).

输入参数includeinvoice_id必填

quipu_list_book_entries

List book entries

List all book entries (invoices, tickets and other accounting entries) in one list. Filter by type, kind, period, dates, payment status or contact.

输入参数qkindpagesorttypeperiodincludepage_sizecontact_idoperation_datepayment_statusvalidation_status另有 1 个

quipu_list_numbering_series

List numbering series

List invoice numbering series (prefixes). Use a series id when you create a draft invoice.

输入参数pageprefixamendingpage_sizeapplicable_to

quipu_list_accounting_categories

List accounting categories

List accounting categories (chart of accounts groups). Filter by kind, prefix or active state.

输入参数kindpageactiveprefixpage_size

quipu_list_accounting_subcategories

List accounting subcategories

List accounting subcategories, optionally for one accounting category.

输入参数pagepage_sizeaccounting_category_id

quipu_create_contact

Create contact

Create a contact (client or supplier). WRITE: it adds a record to the Quipu account. A tax id is needed before you invoice the contact.

输入参数name必填townemailphonetax_idaddresszip_codecountry_code必填client_numberdocument_typebank_account_number

quipu_update_contact

Update contact

Update fields of one contact. WRITE: it changes the record; only the fields you send change.

输入参数nametownemailphonetax_idaddresszip_codecontact_id必填country_codeclient_numberdocument_typebank_account_number

quipu_create_draft_invoice

Create draft invoice

Create a DRAFT income invoice for a contact. WRITE: it adds a draft to Quipu. It sends no issue date or number, so Quipu does not issue or register the invoice; finalize it in the Quipu app.

输入参数tagsitems必填notescontact_id必填operation_datepayment_methodnumbering_series_id

版本历史

8
  1. v1.6.4最新Nov 7, 2026
  2. v1.5.3Nov 5, 2026
  3. v1.5.2Nov 5, 2026
  4. v1.5.1Nov 4, 2026
  5. v1.5.0Nov 3, 2026
  6. v1.4.1Nov 3, 2026
  7. v1.3.0Nov 1, 2026
  8. v1.1.0Oct 31, 2026

评分

已满足适用检查项的 100%

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

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

其他 Usefulapi 集成