Bill.pt MCP by usefulapi
Hosted MCP server connecting Bill.pt invoicing, contacts and stock to AI assistants
- Pricing
- Freemium
- Platforms
- API, CLI, Web
- Runs
- Remotely
- Version
- 1.4.1
- Listing updated
- today
About Bill.pt MCP by usefulapi
Bill.pt MCP by usefulapi is a freemium MCP server for accounting and tax. It runs as a hosted remote server, so there is nothing to install locally.
The README says this is a hosted Model Context Protocol endpoint, so there is nothing to install locally. You add its URL as a remote connector in Claude, ChatGPT, Cursor, VS Code or another MCP client, then sign in with a Bill.pt API token that your own user generates in the Bill.pt account settings.
Once connected, the assistant can list sales documents such as invoices and receipts, look up customers and suppliers with their tax numbers and payment terms, read stock levels per item and store on a given date, and fetch the ids for document types, VAT rates, numbering series and payment methods. Most of the 15 tools are read-only; the only data-changing tool creates a customer or supplier record.
It suits Portuguese businesses that already keep their invoicing in Bill.pt and want to query it in natural language. The Bill.pt API must be included in the user's plan (the page says Basic and above). usefulapi states it is independent and not affiliated with Bill.pt.
Install
Run in a terminal
claude mcp add --transport http bill-pt https://bill-pt.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://bill-pt.usefulapi.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"bill-pt": {
"url": "https://bill-pt.usefulapi.io/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"bill-pt": {
"type": "http",
"url": "https://bill-pt.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bill-pt": {
"serverUrl": "https://bill-pt.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"bill-pt": {
"type": "http",
"url": "https://bill-pt.usefulapi.io/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- billpt_list_document_types
- List document types (invoice FT, simplified invoice FS, credit note NC and others) with their ids.
- billpt_list_payment_methods
- List payment methods with their ids.
- billpt_list_taxes
- List tax (VAT) rates configured in the account, with their ids.
- billpt_list_units
- List units of measure with their ids.
- billpt_list_series
- List document numbering series with their ids.
- billpt_list_stores
- List stores and warehouses with their ids.
- billpt_list_contacts
- List customers and suppliers with their tax numbers, addresses and payment terms.
- billpt_create_contact
- Create a customer or supplier in the Bill.pt account; the code must be unique.
- billpt_list_items
- List products and services with their codes, prices, tax rate and stock flag.
- billpt_list_stock
- Read stock levels per item and store at a date (default now).
- billpt_list_documents
- List invoices, receipts and other sales documents, filtered by type, contact or number.
- billpt_usage_status
- Report the caller's current usage, plan and remaining calls.
- billpt_request_feature
- Send a request to usefulapi for a missing Bill.pt tool, field or filter.
- billpt_upgrade
- Get a paid Pro or Pro+ plan with a payment link.
- billpt_cancel_subscription
- Cancel the Pro subscription at the end of the paid period.
What it does
- Hosted remote endpoint
- Runs on usefulapi's servers at a Streamable HTTP URL, so no local install is needed.
- OAuth sign-in with API token
- Users log in once with their own Bill.pt API token; the page says clients should not send an API key header.
- Invoice and document lookup
- Lists invoices, receipts and other sales documents, filtered by type, contact or number.
- Contacts and items
- Lists customers and suppliers with tax numbers, addresses and payment terms, plus products and services.
- Stock per store
- Reads item stock levels by store at a chosen date, defaulting to now.
- Single write tool
- Only create contact modifies data; the other tools are marked read-only.
Good for
- Look up a customer's recent invoices from an AI chat
- Check a customer's tax number and payment terms before invoicing
- Add a new customer or supplier to Bill.pt from a conversation
- Check stock of specific items across stores
- Find document type, VAT and series ids needed by other tools
Pricing
Freemium, from $9 a month
Free plan with 50 calls/month; Pro from $9/mo; Pro+ from $39/mo
Prices change. Check usefulapi.io before you buy.
Bill.pt MCP by usefulapi FAQ
Is this an official Bill.pt product?
No. The page states usefulapi is an independent service and is not affiliated with or endorsed by Bill.pt.
Can the AI change my Bill.pt data?
Yes, but only through the create contact tool, which the page says saves the record at once. Most MCP clients ask for approval before a tool call runs.
What does it cost?
The Free plan includes 50 tool calls per month. Pro is $9/mo or $90/yr with 10,000 calls per month, and Pro+ is $39/mo or $390/yr with 100,000 calls per month.
Do I put my Bill.pt key in the client config?
No. The page says to add only the URL and not an Authorization header or API key, since the server signs users in with OAuth.
Is Bill.pt MCP by usefulapi free?
Bill.pt MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.
How do I add Bill.pt MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http bill-pt https://bill-pt.usefulapi.io/mcp
What are the best alternatives to Bill.pt MCP by usefulapi?
The closest alternatives to Bill.pt MCP by usefulapi are Fatture in Cloud MCP by usefulapi, KashFlow MCP by usefulapi, CBO MCP by usefulapi, Facture App MCP by usefulapi and FiscalHub MCP by usefulapi.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
Alternatives to Bill.pt MCP by usefulapi
Fatture in Cloud MCP by usefulapi
MCP serverHosted MCP server connecting Fatture in Cloud invoicing to Claude, ChatGPT and Cursor
Not checked yet- 23 tools
- Remote
- Freemium
- Accounting and tax
KashFlow MCP by usefulapi
MCP serverHosted MCP server connecting KashFlow invoices, banking and reports to AI assistants
Not checked yet- 38 tools
- Remote
- Freemium
- Accounting and tax
CBO MCP by usefulapi
MCP serverHosted MCP server connecting AI assistants to CBO invoices, orders, clients and products
Not checked yet- 30 tools
- Remote
- Freemium
- Accounting and tax
Facture App MCP by usefulapi
MCP serverHosted MCP server to stamp, cancel and list CFDI invoices in Facture App for Mexican
Not checked yet- 10 tools
- Remote
- Freemium
- Finance and payments
FiscalHub MCP by usefulapi
MCP serverHosted MCP server for Brazilian NF-e and NFC-e tax documents and NCM lookups in FiscalHub
Not checked yet- 9 tools
- Remote
- Freemium
- Accounting and tax
Doklado MCP by usefulapi
MCP serverHosted MCP connector that lets AI assistants read and update Doklado accounting documents
Not checked yet- 9 tools
- Remote
- Freemium
- Accounting and tax