billey MCP by usefulapi
Read clients, invoices, expenses, bank transactions and time entries in billey.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"billey": {
"url": "https://billey.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://billey.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (11)
🟢billey_list_clients(per_page, updated_after, fields, cursor)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"per_page": {
"description": "Rows per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"updated_after": {
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"fields": {
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included.",
"type": "string"
},
"cursor": {
"description": "Cursor from links.next or links.prev of an earlier response.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billey_get_client(client_id)
Get one client by id, with its contact and payment details. billey API: GET /api/v1/clients/{client}.
Eingabe-Schema
{
"type": "object",
"properties": {
"client_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric billey id."
}
},
"required": [
"client_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billey_list_invoices(per_page, updated_after, fields, cursor)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"per_page": {
"description": "Rows per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"updated_after": {
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"fields": {
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included.",
"type": "string"
},
"cursor": {
"description": "Cursor from links.next or links.prev of an earlier response.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billey_get_invoice(invoice_id)
Get one invoice by id, with its client summary and line items. billey API: GET /api/v1/invoices/{invoice}.
Eingabe-Schema
{
"type": "object",
"properties": {
"invoice_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric billey id."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billey_list_quotes(per_page, updated_after, fields, cursor)
List quotes (offers) with status, dates, totals and line items. Returns cursor pagination. billey API: GET /api/v1/quotes (needs the quotes:read ability).
Eingabe-Schema
{
"type": "object",
"properties": {
"per_page": {
"description": "Rows per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"updated_after": {
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"fields": {
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included.",
"type": "string"
},
"cursor": {
"description": "Cursor from links.next or links.prev of an earlier response.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billey_list_expenses(per_page, updated_after, fields, cursor)
List expenses (purchase costs) with amounts, dates, the vendor summary and the account. Returns cursor pagination. billey API: GET /api/v1/expenses.
Eingabe-Schema
{
"type": "object",
"properties": {
"per_page": {
"description": "Rows per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"updated_after": {
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"fields": {
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included.",
"type": "string"
},
"cursor": {
"description": "Cursor from links.next or links.prev of an earlier response.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billey_list_vendors(per_page, updated_after, fields, cursor)
List vendors (suppliers) with their contact and payment details. Returns cursor pagination. billey API: GET /api/v1/vendors.
Eingabe-Schema
{
"type": "object",
"properties": {
"per_page": {
"description": "Rows per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"updated_after": {
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"fields": {
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included.",
"type": "string"
},
"cursor": {
"description": "Cursor from links.next or links.prev of an earlier response.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billey_list_bank_transactions(per_page, updated_after, fields, cursor)
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).
Eingabe-Schema
{
"type": "object",
"properties": {
"per_page": {
"description": "Rows per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"updated_after": {
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"fields": {
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included.",
"type": "string"
},
"cursor": {
"description": "Cursor from links.next or links.prev of an earlier response.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billey_list_products(per_page, updated_after, fields, cursor)
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).
Eingabe-Schema
{
"type": "object",
"properties": {
"per_page": {
"description": "Rows per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"updated_after": {
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"fields": {
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included.",
"type": "string"
},
"cursor": {
"description": "Cursor from links.next or links.prev of an earlier response.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billey_list_projects(per_page, updated_after, fields, cursor)
List projects with their client summary. Returns cursor pagination. billey API: GET /api/v1/projects (needs projects:read).
Eingabe-Schema
{
"type": "object",
"properties": {
"per_page": {
"description": "Rows per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"updated_after": {
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"fields": {
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included.",
"type": "string"
},
"cursor": {
"description": "Cursor from links.next or links.prev of an earlier response.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billey_list_time_entries(per_page, updated_after, fields, cursor)
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).
Eingabe-Schema
{
"type": "object",
"properties": {
"per_page": {
"description": "Rows per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"updated_after": {
"description": "Only rows updated strictly after this UTC time, e.g. 2026-10-01T00:00:00Z (incremental sync).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"fields": {
"description": "Comma-separated top-level keys to return, e.g. id,invoice_number,total. id is always included.",
"type": "string"
},
"cursor": {
"description": "Cursor from links.next or links.prev of an earlier response.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis