billey MCP by usefulapi
Read clients, invoices, expenses, bank transactions and time entries in billey.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"billey": {
"url": "https://billey.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://billey.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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).
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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).
입력 스키마
{
"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).
입력 스키마
{
"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).
입력 스키마
{
"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).
입력 스키마
{
"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"
}커뮤니티
증거