Skip to content
MCP server

Bill.pt MCP by usefulapi

Hosted MCP server connecting Bill.pt invoicing, contacts and stock to AI assistants

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://bill-pt.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bill-pt": {
      "url": "https://bill-pt.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers

Alternatives to Bill.pt MCP by usefulapi

  1. Hosted MCP server connecting Fatture in Cloud invoicing to Claude, ChatGPT and Cursor

    Not checked yet
    • 23 tools
    • Remote
    • Freemium
    • Accounting and tax
  2. Hosted MCP server connecting KashFlow invoices, banking and reports to AI assistants

    Not checked yet
    • 38 tools
    • Remote
    • Freemium
    • Accounting and tax
  3. Hosted MCP server connecting AI assistants to CBO invoices, orders, clients and products

    Not checked yet
    • 30 tools
    • Remote
    • Freemium
    • Accounting and tax
  4. Hosted MCP server to stamp, cancel and list CFDI invoices in Facture App for Mexican

    Not checked yet
    • 10 tools
    • Remote
    • Freemium
    • Finance and payments
  5. Hosted 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
  6. Hosted MCP connector that lets AI assistants read and update Doklado accounting documents

    Not checked yet
    • 9 tools
    • Remote
    • Freemium
    • Accounting and tax