billey MCP by usefulapi
Read clients, invoices, expenses, bank transactions and time entries in billey.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"billey": {
"url": "https://billey.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://billey.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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).
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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"
}Comunidad
Evidencia