billey MCP by usefulapi is an MCP server published by io.usefulapi, hosted at billey.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 11 tools, including billey_list_clients, billey_get_client, billey_list_invoices, billey_get_invoice, billey_list_quotes.
Read clients, invoices, expenses, bank transactions and time entries in billey.
4,240 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the clients of the book (name, contact, payment terms, collection method). Returns cursor pagination: follow links.next. Use updated_after to sync only changes. billey API: GET /api/v1/clients.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | Cursor from links.next or links.prev of an earlier response. |
| fields | string | Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included. |
| per_page | integer | Rows per page, 1-100 (default 25). |
| updated_after | string | Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync). |
{
"name": "billey_list_clients",
"title": "List clients",
"description": "List the clients of the book (name, contact, payment terms, collection method). Returns cursor pagination: follow links.next. Use updated_after to sync only changes. billey API: GET /api/v1/clients.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"type": "string",
"description": "Cursor from links.next or links.prev of an earlier response."
},
"fields": {
"type": "string",
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"updated_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync)."
}
}
},
"annotations": {
"title": "List clients",
"readOnlyHint": true
}
}Get one client by id, with its contact and payment details. billey API: GET /api/v1/clients/{client}.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | Numeric billey id. |
{
"name": "billey_get_client",
"title": "Get a client",
"description": "Get one client by id, with its contact and payment details. billey API: GET /api/v1/clients/{client}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Numeric billey id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a client",
"readOnlyHint": true
}
}List invoices with status, dates, totals (decimal strings), the client summary and line items. Filter with updated_after for changes since a time. Returns cursor pagination. billey API: GET /api/v1/invoices.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | Cursor from links.next or links.prev of an earlier response. |
| fields | string | Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included. |
| per_page | integer | Rows per page, 1-100 (default 25). |
| updated_after | string | Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync). |
{
"name": "billey_list_invoices",
"title": "List invoices",
"description": "List invoices with status, dates, totals (decimal strings), the client summary and line items. Filter with updated_after for changes since a time. Returns cursor pagination. billey API: GET /api/v1/invoices.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"type": "string",
"description": "Cursor from links.next or links.prev of an earlier response."
},
"fields": {
"type": "string",
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"updated_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync)."
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true
}
}Get one invoice by id, with its client summary and line items. billey API: GET /api/v1/invoices/{invoice}.
| Parameter | Type | Description |
|---|---|---|
| invoice_id * | integer | Numeric billey id. |
{
"name": "billey_get_invoice",
"title": "Get an invoice",
"description": "Get one invoice by id, with its client summary and line items. billey API: GET /api/v1/invoices/{invoice}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id"
],
"properties": {
"invoice_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Numeric billey id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an invoice",
"readOnlyHint": true
}
}List quotes (offers) with status, dates, totals and line items. Returns cursor pagination. billey API: GET /api/v1/quotes (needs the quotes:read ability).
| Parameter | Type | Description |
|---|---|---|
| cursor | string | Cursor from links.next or links.prev of an earlier response. |
| fields | string | Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included. |
| per_page | integer | Rows per page, 1-100 (default 25). |
| updated_after | string | Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync). |
{
"name": "billey_list_quotes",
"title": "List quotes",
"description": "List quotes (offers) with status, dates, totals and line items. Returns cursor pagination. billey API: GET /api/v1/quotes (needs the quotes:read ability).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"type": "string",
"description": "Cursor from links.next or links.prev of an earlier response."
},
"fields": {
"type": "string",
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"updated_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync)."
}
}
},
"annotations": {
"title": "List quotes",
"readOnlyHint": true
}
}List expenses (purchase costs) with amounts, dates, the vendor summary and the account. Returns cursor pagination. billey API: GET /api/v1/expenses.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | Cursor from links.next or links.prev of an earlier response. |
| fields | string | Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included. |
| per_page | integer | Rows per page, 1-100 (default 25). |
| updated_after | string | Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync). |
{
"name": "billey_list_expenses",
"title": "List expenses",
"description": "List expenses (purchase costs) with amounts, dates, the vendor summary and the account. Returns cursor pagination. billey API: GET /api/v1/expenses.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"type": "string",
"description": "Cursor from links.next or links.prev of an earlier response."
},
"fields": {
"type": "string",
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"updated_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync)."
}
}
},
"annotations": {
"title": "List expenses",
"readOnlyHint": true
}
}List vendors (suppliers) with their contact and payment details. Returns cursor pagination. billey API: GET /api/v1/vendors.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | Cursor from links.next or links.prev of an earlier response. |
| fields | string | Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included. |
| per_page | integer | Rows per page, 1-100 (default 25). |
| updated_after | string | Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync). |
{
"name": "billey_list_vendors",
"title": "List vendors",
"description": "List vendors (suppliers) with their contact and payment details. Returns cursor pagination. billey API: GET /api/v1/vendors.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"type": "string",
"description": "Cursor from links.next or links.prev of an earlier response."
},
"fields": {
"type": "string",
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"updated_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync)."
}
}
},
"annotations": {
"title": "List vendors",
"readOnlyHint": true
}
}List imported bank transactions (amount, executed date, counterparty, match and allocation state). Returns cursor pagination. billey API: GET /api/v1/bank-transactions (needs transactions:read).
| Parameter | Type | Description |
|---|---|---|
| cursor | string | Cursor from links.next or links.prev of an earlier response. |
| fields | string | Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included. |
| per_page | integer | Rows per page, 1-100 (default 25). |
| updated_after | string | Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync). |
{
"name": "billey_list_bank_transactions",
"title": "List bank transactions",
"description": "List imported bank transactions (amount, executed date, counterparty, match and allocation state). Returns cursor pagination. billey API: GET /api/v1/bank-transactions (needs transactions:read).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"type": "string",
"description": "Cursor from links.next or links.prev of an earlier response."
},
"fields": {
"type": "string",
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"updated_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync)."
}
}
},
"annotations": {
"title": "List bank transactions",
"readOnlyHint": true
}
}List products and services from the book's catalogue (unit price, VAT percentage, SKU). Returns cursor pagination. billey API: GET /api/v1/products (needs products:read).
| Parameter | Type | Description |
|---|---|---|
| cursor | string | Cursor from links.next or links.prev of an earlier response. |
| fields | string | Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included. |
| per_page | integer | Rows per page, 1-100 (default 25). |
| updated_after | string | Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync). |
{
"name": "billey_list_products",
"title": "List products",
"description": "List products and services from the book's catalogue (unit price, VAT percentage, SKU). Returns cursor pagination. billey API: GET /api/v1/products (needs products:read).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"type": "string",
"description": "Cursor from links.next or links.prev of an earlier response."
},
"fields": {
"type": "string",
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"updated_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync)."
}
}
},
"annotations": {
"title": "List products",
"readOnlyHint": true
}
}List projects with their client summary. Returns cursor pagination. billey API: GET /api/v1/projects (needs projects:read).
| Parameter | Type | Description |
|---|---|---|
| cursor | string | Cursor from links.next or links.prev of an earlier response. |
| fields | string | Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included. |
| per_page | integer | Rows per page, 1-100 (default 25). |
| updated_after | string | Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync). |
{
"name": "billey_list_projects",
"title": "List projects",
"description": "List projects with their client summary. Returns cursor pagination. billey API: GET /api/v1/projects (needs projects:read).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"type": "string",
"description": "Cursor from links.next or links.prev of an earlier response."
},
"fields": {
"type": "string",
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"updated_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync)."
}
}
},
"annotations": {
"title": "List projects",
"readOnlyHint": true
}
}List logged time entries (hours and hourly rate as decimal strings, date, project). Returns cursor pagination. billey API: GET /api/v1/time-entries (needs time-entries:read).
| Parameter | Type | Description |
|---|---|---|
| cursor | string | Cursor from links.next or links.prev of an earlier response. |
| fields | string | Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included. |
| per_page | integer | Rows per page, 1-100 (default 25). |
| updated_after | string | Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync). |
{
"name": "billey_list_time_entries",
"title": "List time entries",
"description": "List logged time entries (hours and hourly rate as decimal strings, date, project). Returns cursor pagination. billey API: GET /api/v1/time-entries (needs time-entries:read).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"type": "string",
"description": "Cursor from links.next or links.prev of an earlier response."
},
"fields": {
"type": "string",
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"updated_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync)."
}
}
},
"annotations": {
"title": "List time entries",
"readOnlyHint": true
}
}Tools for billey, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which invoices are still unpaid, and how many days overdue is each one?"; "Show me all expenses from October 2026 with their VAT amounts."; "List the time entries logged on project X this month.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes billey data. Free plan: 50 tool calls per month. Run billey_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run billey_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run billey_upgrade without a plan: it returns both plans, each with a payment link for the user to open. billey_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.