Billify MCP by usefulapi
Read clients, offers and invoices; create clients and offer drafts in Billify.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"billify": {
"url": "https://billify.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://billify.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (8)
🟢billify_list_clients(company_name)
List the newest 100 clients of the company, without deleted ones. Billify has no paging and no filter in its API: company_name matches only those 100, without case. Use it before creating a client. Billify API: GET /api/v1/clients.
입력 스키마
{
"type": "object",
"properties": {
"company_name": {
"description": "Only clients whose company name contains this text (no case).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billify_get_client(client_id)
Get one client by id, with its contact details, address, language and the number of its invoices and offers. Billify API: GET /api/v1/clients/{id}.
입력 스키마
{
"type": "object",
"properties": {
"client_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Client id."
}
},
"required": [
"client_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴billify_create_client(company_name, address, postal_code, city, country, ...)
Create a client. First searches the newest 100 clients: a company name that matches (no case) returns that client and creates nothing. Billify also answers 409 for an existing name, and this tool then returns that client. Duplicates are never created: Billify's allowDuplicate option is not offered. Billify API: POST /api/v1/clients.
입력 스키마
{
"type": "object",
"properties": {
"company_name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Company name. Billify matches an existing client by this name, without case."
},
"address": {
"description": "Street and number.",
"type": "string",
"maxLength": 300
},
"postal_code": {
"description": "Postal code.",
"type": "string",
"maxLength": 20
},
"city": {
"description": "City.",
"type": "string",
"maxLength": 100
},
"country": {
"description": "Country, for example Schweiz.",
"type": "string",
"maxLength": 100
},
"main_contact_name": {
"description": "Main contact person.",
"type": "string",
"maxLength": 200
},
"main_contact_email": {
"description": "Main contact email address.",
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"main_contact_phone": {
"description": "Main contact phone number.",
"type": "string",
"maxLength": 50
},
"industry": {
"description": "Industry.",
"type": "string",
"maxLength": 100
},
"website": {
"description": "Website.",
"type": "string",
"maxLength": 500
},
"language": {
"description": "Language of the client's documents. Omit to use the company language.",
"type": "string",
"enum": [
"de",
"en",
"fr",
"it"
]
},
"notes": {
"description": "Internal notes. Not shown to the client.",
"type": "string",
"maxLength": 5000
}
},
"required": [
"company_name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billify_list_offers(client_id, status)
List the newest 100 offers with their line items. Billify has no paging and no filter in its API: client_id and status match only those 100. Billify API: GET /api/v1/offers.
입력 스키마
{
"type": "object",
"properties": {
"client_id": {
"description": "Only records of this client id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"status": {
"description": "Only offers with this status.",
"type": "string",
"enum": [
"DRAFT",
"SENT",
"ACCEPTED",
"REJECTED",
"EXPIRED",
"CONVERTED"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billify_get_offer(offer_id)
Get one offer by id, with its line items, status, amounts and dates. Billify API: GET /api/v1/offers/{id}.
입력 스키마
{
"type": "object",
"properties": {
"offer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Offer id."
}
},
"required": [
"offer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴billify_create_offer(client_id, title, items, offer_date, valid_until, ...)
Create an offer as a DRAFT for an existing client. Billify sets the offer number, computes each total and amount, and ignores any amount sent, so none are sent. The offer is not sent to the client: the user sends it in Billify after checking the preview. The response includes appUrl. Billify API: POST /api/v1/offers.
입력 스키마
{
"type": "object",
"properties": {
"client_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Client id."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Offer title."
},
"items": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Line item name."
},
"details": {
"description": "Text under the line item name.",
"type": "string",
"maxLength": 5000
},
"quantity": {
"description": "Quantity. Omit for 1.",
"type": "number",
"exclusiveMinimum": 0
},
"unit": {
"description": "Unit, for example Stk, Std. or Pauschale. Omit for Stk.",
"type": "string",
"maxLength": 50
},
"unit_price": {
"type": "number",
"minimum": 0,
"description": "Price per unit, excluding VAT, as a decimal in the document currency (e.g. 1250.5). Not in cents."
}
},
"required": [
"description",
"unit_price"
]
},
"description": "Line items, in order. Billify computes each total."
},
"offer_date": {
"description": "Offer date, YYYY-MM-DD. Omit for today.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"valid_until": {
"description": "Offer valid until, YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"vat_rate": {
"description": "VAT rate in percent: 8.1, 2.6, 3.8 or 0. Omit for 8.1 (0 for companies without VAT).",
"anyOf": [
{
"type": "number",
"const": 8.1
},
{
"type": "number",
"const": 2.6
},
{
"type": "number",
"const": 3.8
},
{
"type": "number",
"const": 0
}
]
},
"discount": {
"description": "Discount. Send together with discount_type.",
"type": "number",
"minimum": 0
},
"discount_type": {
"description": "PERCENT (at most 100) or AMOUNT.",
"type": "string",
"enum": [
"PERCENT",
"AMOUNT"
]
},
"notes": {
"description": "Remarks printed on the offer.",
"type": "string",
"maxLength": 5000
},
"language": {
"description": "Document language. Omit to use the client's language.",
"type": "string",
"enum": [
"de",
"en",
"fr",
"it"
]
},
"currency": {
"description": "CHF or EUR. Omit for CHF.",
"type": "string",
"enum": [
"CHF",
"EUR"
]
},
"billing_type": {
"description": "ONE_TIME, or MONTHLY for recurring billing.",
"type": "string",
"enum": [
"ONE_TIME",
"MONTHLY"
]
},
"billing_months": {
"description": "Number of months. Only with billing_type MONTHLY.",
"type": "integer",
"minimum": 1,
"maximum": 120
}
},
"required": [
"client_id",
"title",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billify_list_invoices(client_id, status)
List the newest 100 invoices with their line items. Invoices cannot be created, sent, changed or deleted through this API. Billify has no paging and no filter: client_id and status match only those 100. Billify API: GET /api/v1/invoices.
입력 스키마
{
"type": "object",
"properties": {
"client_id": {
"description": "Only records of this client id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"status": {
"description": "Only invoices with this status.",
"type": "string",
"enum": [
"DRAFT",
"OPEN",
"PARTIALLY_PAID",
"PAID",
"OVERDUE",
"CANCELLED"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billify_get_invoice(invoice_id)
Get one invoice by id, with its line items, status, dates, amounts, payment status and QR reference. Billify API: GET /api/v1/invoices/{id}.
입력 스키마
{
"type": "object",
"properties": {
"invoice_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Invoice id."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거