billey MCP by usefulapi

Read clients, invoices, expenses, bank transactions and time entries in billey.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
92%
이름 품질
80%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,351토큰 (도구 정의)
~1.6 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.84%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 11개