Billy MCP by usefulapi
io.usefulapi/billyusefulapi.iostreamable-httpv1.27.4Scanned
Read Billy invoices, bills, contacts, products and postings; create contacts and draft invoices.
15 tools: 2 can delete or cancel things and 13 only read.
- Reads private data · 3
- Reads text others write · 1
- Can send data out · 0
- No findings
The remote endpoint did not answer the last look. Remote posture
Anlyon alternative
2 of these tools change something. Run those as governed actions.
Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.
Anlyon Radar does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.
Import an OpenAPI spec →What the Billy MCP by usefulapi can do
The Billy MCP by usefulapi is published by usefulapi.io, a domain the MCP Registry verified. It has 15 tools. It can delete or cancel things (2 tools: billy_create_contact and billy_create_draft_invoice). 13 tools only read.
3 tools read private data (billy_list_contacts, billy_get_contact and billy_list_invoices); 1 tool brings in text other people can write (billy_get_contact).
None of the fixed checks matched anything in its tool definitions. That is not a safety guarantee.
Last scanned Oct 25, 2026, version 1.27.4.
Tools
Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.
15 tools
Deletes or cancels 2Claude Code: deny
billy_create_contactWRITE: create ONE new contact (customer and/or supplier) in the company's Billy account.No findings
Why it is in this group
- The name "billy_create_contact" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it WRITE: create ONE new contact (customer and/or supplier) in the company's Billy account. It does not check for duplicates (call billy_list_contacts first) and nothing is sent to the contact. Not idempotent: a repeat call creates a second contact. POST /contacts.
Annotations the server declares
- title: Create a contact
- destructiveHint: true
billy_create_draft_invoiceWRITE: create ONE invoice in the DRAFT state for an existing contact.No findings
Why it is in this group
- The name "billy_create_draft_invoice" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it WRITE: create ONE invoice in the DRAFT state for an existing contact. The invoice is NOT approved, booked, numbered into the ledger or sent: the user reviews it in Billy and approves and sends it there. The invoice number is assigned by Billy. No payment is created. Not idempotent: a repeat call creates a second draft. POST /invoices with state=draft.
Annotations the server declares
- title: Create a draft invoice
- destructiveHint: true
Only reads 13Show 13 read-only tools
billy_get_billOne supplier bill by id with its lines.No findings
Why it is in this group
- The name "billy_get_bill" says "get": a word for reading.
Description, as the server wrote it One supplier bill by id with its lines. GET /bills/{id}.
Annotations the server declares
- title: Get a bill
- readOnlyHint: true
billy_get_contactOne contact by id, with its contact persons (names and e-mail addresses).Reads private dataReads text others writeNo findings
Why it is in this group
- The name "billy_get_contact" says "get": a word for reading.
What it can reach
- private-dataThe name "billy_get_contact" says "get" and "contact": it reads contacts.
- private-dataThe description's first sentence says "contact": it reads contacts.
- untrusted-inputThe description's first sentence says "mail": it reads inbound email, which other people can write.
Description, as the server wrote it One contact by id, with its contact persons (names and e-mail addresses). GET /contacts/{id}.
Annotations the server declares
- title: Get a contact
- readOnlyHint: true
billy_get_invoiceOne invoice by id with its lines (product, description, quantity, unit price, amount, tax) and its payment associations.No findings
Why it is in this group
- The name "billy_get_invoice" says "get": a word for reading.
Description, as the server wrote it One invoice by id with its lines (product, description, quantity, unit price, amount, tax) and its payment associations. GET /invoices/{id}.
Annotations the server declares
- title: Get an invoice
- readOnlyHint: true
billy_get_organizationThe Billy company the access token belongs to: id, name, address, registration (CVR) number, base currency, VAT settings, fiscal year, default payment terms, invoice numbering, def…No findings
Why it is in this group
- The name "billy_get_organization" says "get": a word for reading.
Description, as the server wrote it The Billy company the access token belongs to: id, name, address, registration (CVR) number, base currency, VAT settings, fiscal year, default payment terms, invoice numbering, default accounts. Good first call. GET /organization.
Annotations the server declares
- title: Get the company
- readOnlyHint: true
billy_get_productOne product by id with its unit prices per currency.No findings
Why it is in this group
- The name "billy_get_product" says "get": a word for reading.
Description, as the server wrote it One product by id with its unit prices per currency. GET /products/{id}.
Annotations the server declares
- title: Get a product
- readOnlyHint: true
billy_list_accountsThe chart of accounts: account number, name, group, nature, VAT rate, bank-account flag and bank details (IBAN, bank name) of bank accounts.No findings
Why it is in this group
- The name "billy_list_accounts" says "list": a word for reading.
Description, as the server wrote it The chart of accounts: account number, name, group, nature, VAT rate, bank-account flag and bank details (IBAN, bank name) of bank accounts. With is_bank_account=true this lists the bank accounts whose ids billy_list_bank_lines needs. Paged. GET /accounts.
Annotations the server declares
- title: List accounts (chart of accounts)
- readOnlyHint: true
billy_list_bank_linesList the bank-statement lines of ONE bank account (read only; nothing is matched or reconciled): date, description, amount, side (debit/credit), reconciled flag, receipt state.No findings
Why it is in this group
- The name "billy_list_bank_lines" says "list": a word for reading.
Description, as the server wrote it List the bank-statement lines of ONE bank account (read only; nothing is matched or reconciled): date, description, amount, side (debit/credit), reconciled flag, receipt state. Get the account id from billy_list_accounts with is_bank_account=true. Paged. GET /bankLines.
Annotations the server declares
- title: List bank lines
- readOnlyHint: true
billy_list_billsList bills (purchase invoices from suppliers): supplier, dates, state (draft/approved/voided), amount, balance, isPaid, supplier invoice number.No findings
Why it is in this group
- The name "billy_list_bills" says "list": a word for reading.
Description, as the server wrote it List bills (purchase invoices from suppliers): supplier, dates, state (draft/approved/voided), amount, balance, isPaid, supplier invoice number. Filter by state, supplier, dates or paid status. Paged. GET /bills.
Annotations the server declares
- title: List bills (supplier invoices)
- readOnlyHint: true
billy_list_contactsList customers and suppliers: name, type, address, CVR/registration number, EAN, payment terms, customer/supplier flags.Reads private dataNo findings
Why it is in this group
- The name "billy_list_contacts" says "list": a word for reading.
What it can reach
- private-dataThe name "billy_list_contacts" says "list" and "contact": it reads contacts.
Description, as the server wrote it List customers and suppliers: name, type, address, CVR/registration number, EAN, payment terms, customer/supplier flags. The API has no documented search filter, so `search` is applied to the returned page only (case-insensitive on name, contact number and registration number); page on with next_page to look further. Paged. GET /contacts.
Annotations the server declares
- title: List contacts
- readOnlyHint: true
billy_list_invoicesList sales invoices and credit notes (newest first by default): number, date, due date, state (draft/approved/voided), amount, tax, balance, isPaid, contactId, currency.Reads private dataNo findings
Why it is in this group
- The name "billy_list_invoices" says "list": a word for reading.
What it can reach
- private-dataThe description's first sentence says "list" and "note": it reads notes.
Description, as the server wrote it List sales invoices and credit notes (newest first by default): number, date, due date, state (draft/approved/voided), amount, tax, balance, isPaid, contactId, currency. Filter by state, customer, number, date, period, paid status or free text. Paged. GET /invoices.
Annotations the server declares
- title: List invoices
- readOnlyHint: true
billy_list_postingsList ledger postings (the bookkeeping entries): date, text, account, amount, side (debit/credit), currency, voided flag.No findings
Why it is in this group
- The name "billy_list_postings" says "list": a word for reading.
Description, as the server wrote it List ledger postings (the bookkeeping entries): date, text, account, amount, side (debit/credit), currency, voided flag. Filter by account, date or period. Read only. Paged. GET /postings.
Annotations the server declares
- title: List ledger postings
- readOnlyHint: true
billy_list_productsList products and services usable as invoice lines: name, product number, description, sales account, archived flag.No findings
Why it is in this group
- The name "billy_list_products" says "list": a word for reading.
Description, as the server wrote it List products and services usable as invoice lines: name, product number, description, sales account, archived flag. The API has no documented search filter, so `search` is applied to the returned page only (name, productNo). Paged. GET /products.
Annotations the server declares
- title: List products
- readOnlyHint: true
billy_list_tax_ratesThe company's VAT rates: name, rate (as a fraction, 0.25 = 25 percent), whether it applies to sales or purchases, active flag.No findings
Why it is in this group
- The name "billy_list_tax_rates" says "list": a word for reading.
Description, as the server wrote it The company's VAT rates: name, rate (as a fraction, 0.25 = 25 percent), whether it applies to sales or purchases, active flag. Paged. GET /taxRates.
Annotations the server declares
- title: List tax (VAT) rates
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged outbound.
- Reads private data3
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write1
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out0
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Nov 20, 2026, 19:33 UTC, unchanged since Oct 29, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- no
- HTTP status of an anonymous initialize
- not observed
- tools/list served without credentials
- no
- Tools that change things, listed without credentials
- 0
- Protocol version
- not observed
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- not observed
- RFC 9728 protected resource metadata
- not observed
- Authorization servers
- not observed
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- not observed
- Client ID metadata documents
- not observed
The probe stopped: The server redirected a POST to a different request.
Posture changes
- Oct 29, 2026
- Reachable: yes to no
- HTTP status of an anonymous initialize: 200 to none
- tools/list served without credentials: yes to no
- Tools that change things, listed without credentials: 2 to 0
- Protocol version: 2025-06-18 to none
- RFC 9728 protected resource metadata: https://billy.usefulapi.io/.well-known/oauth-protected-resource/mcp to none
- Authorization servers: https://billy.usefulapi.io to none
- Dynamic client registration: yes to not observed
- Client ID metadata documents: no to not observed
Findings
Matches of fixed checks, with the text they matched.
No check matched anything in these tool definitions. That is not a safety guarantee.
History
Changes to its tool definitions and to its remote endpoint, newest first.
PostureRemote posture changed. Reachable: yes -> no; HTTP status of an anonymous initialize: 200 -> none; tools/list served without credentials: yes -> no (and 6 more).View diff
- Reachable: yes to no
- HTTP status of an anonymous initialize: 200 to none
- tools/list served without credentials: yes to no
- Tools that change things, listed without credentials: 2 to 0
- Protocol version: 2025-06-18 to none
- RFC 9728 protected resource metadata: https://billy.usefulapi.io/.well-known/oauth-protected-resource/mcp to none
- Authorization servers: https://billy.usefulapi.io to none
- Dynamic client registration: yes to not observed
- Client ID metadata documents: no to not observed
Install
Pinned to version 1.27.4. Values in angle brackets are yours to fill in.
claude mcp add --transport http billy https://billy.usefulapi.io/mcpclaude mcp add --transport http billy https://billy.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__billy__billy_get_organization",
"mcp__billy__billy_list_contacts",
"mcp__billy__billy_get_contact",
"mcp__billy__billy_list_invoices",
"mcp__billy__billy_get_invoice",
"mcp__billy__billy_list_bills",
"mcp__billy__billy_get_bill",
"mcp__billy__billy_list_products",
"mcp__billy__billy_get_product",
"mcp__billy__billy_list_accounts",
"mcp__billy__billy_list_tax_rates",
"mcp__billy__billy_list_bank_lines",
"mcp__billy__billy_list_postings"
],
"ask": [],
"deny": [
"mcp__billy__billy_create_contact",
"mcp__billy__billy_create_draft_invoice"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as billy. Review it before you use it.
Capability tags behind 3 rules
- mcp__billy__billy_list_contacts private-data
- mcp__billy__billy_get_contact private-data, untrusted-input
- mcp__billy__billy_list_invoices private-data
Pin
Keep the decision: fail CI when the tools change, follow every change, or show a badge.
Pin in CI
Fail a build when the tools you reviewed are not the tools the server serves today.
curl -s "https://radar.anlyon.com/api/v1/servers/io.usefulapi/billy/verify?hash=964c8bf097e60fb358d0e0904c8bc3074193130f945c722658c370db97856c84" | jq -e '.changed == false'Pinned hash 964c8bf097e6, from Oct 25, 2026, 23:20 UTC.
Watch
Get told when its tools change: a new tool, a new description, a new class.
https://radar.anlyon.com/servers/io.usefulapi/billy/changes.xmlAn Atom feed. Works in any feed reader or Slack's RSS app.
Badge
[](https://radar.anlyon.com/servers/io.usefulapi/billy)Source: MCP Registry · repository. Synced Nov 18, 2026, 11:18 UTC.
Billy MCP by usefulapi: questions and answers
Answered from the scan above, not from the publisher's description.
Is the Billy MCP by usefulapi safe?
- No scan can promise that. What its definitions show: 15 tools, 2 of which can change, send or delete something, and 0 findings from fixed checks. Allow the reads, ask before each change, and deny the deletes; the permissions block on this page does that.
Can the Billy MCP by usefulapi delete data?
- Yes. 2 tools can delete, cancel or revoke something: billy_create_contact and billy_create_draft_invoice.
Can the Billy MCP by usefulapi do things that cannot be undone?
- No tool is classed as irreversible: none of them sends, pays, publishes or merges, going by their definitions.
What tools does the Billy MCP by usefulapi have?
- 15 tools: 2 destructive, 13 read. billy_create_contact, billy_create_draft_invoice, billy_get_organization, billy_list_contacts, billy_get_contact, billy_list_invoices, billy_get_invoice, billy_list_bills and 7 more.
Does the Billy MCP by usefulapi need sign-in or OAuth?
- Its remote endpoint did not answer the last anonymous look.
Does the Billy MCP by usefulapi send data to outside services?
- None of its tools sends, posts or publishes, or takes a recipient, channel or URL.
Has the Billy MCP by usefulapi changed its tools?
- Not since Anlyon Radar started tracking it. Last scanned Oct 25, 2026.