# Bill.pt MCP by usefulapi

> Bill.pt MCP by usefulapi is a freemium MCP server for accounting and tax. Hosted MCP server connecting Bill.pt invoicing, contacts and stock to AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, CLI, Web, vscode
- **Website:** https://usefulapi.io/bill-pt/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/bill-pt
- **MCP Registry name:** io.usefulapi/bill-pt
- **Categories:** accounting and tax
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bill-pt https://bill-pt.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://bill-pt.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bill-pt": {
      "url": "https://bill-pt.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bill-pt": {
      "type": "http",
      "url": "https://bill-pt.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bill-pt": {
      "serverUrl": "https://bill-pt.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bill-pt": {
      "type": "http",
      "url": "https://bill-pt.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [Fatture in Cloud MCP by usefulapi](https://ai-powered.com/mcp/fatture-in-cloud-mcp-by-usefulapi): Fatture in Cloud MCP by usefulapi is a freemium MCP server for accounting and tax.
- [KashFlow MCP by usefulapi](https://ai-powered.com/mcp/kashflow-mcp-by-usefulapi): KashFlow MCP by usefulapi is a freemium MCP server for accounting and tax.
- [CBO MCP by usefulapi](https://ai-powered.com/mcp/cbo-mcp-by-usefulapi): CBO MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Facture App MCP by usefulapi](https://ai-powered.com/mcp/facture-app-mcp-by-usefulapi): Facture App MCP by usefulapi is a freemium MCP server for finance and payments.
- [FiscalHub MCP by usefulapi](https://ai-powered.com/mcp/fiscalhub-mcp-by-usefulapi): FiscalHub MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Doklado MCP by usefulapi](https://ai-powered.com/mcp/doklado-mcp-by-usefulapi): Doklado MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Collmex MCP by usefulapi](https://ai-powered.com/mcp/collmex-mcp-by-usefulapi): Collmex MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Invoices Online MCP by usefulapi](https://ai-powered.com/mcp/invoices-online-mcp-by-usefulapi): Invoices Online MCP by usefulapi is a freemium MCP server for accounting and tax.

---
Source: https://ai-powered.com/mcp/bill-pt-mcp-by-usefulapi
