Billify MCP by usefulapi is an MCP server published by io.usefulapi, hosted at billify.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 8 tools, including billify_list_clients, billify_get_client, billify_create_client, billify_list_offers, billify_get_offer.
Read clients, offers and invoices; create clients and offer drafts in Billify.
4,105 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| company_name | string | Only clients whose company name contains this text (no case). |
{
"name": "billify_list_clients",
"title": "List clients",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"company_name": {
"type": "string",
"description": "Only clients whose company name contains this text (no case)."
}
}
},
"annotations": {
"title": "List clients",
"readOnlyHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | Client id. |
{
"name": "billify_get_client",
"title": "Get a client",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Client id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a client",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| city | string | City. |
| notes | string | Internal notes. Not shown to the client. |
| address | string | Street and number. |
| country | string | Country, for example Schweiz. |
| website | string | Website. |
| industry | string | Industry. |
| language | string | Language of the client's documents. Omit to use the company language. |
| postal_code | string | Postal code. |
| company_name * | string | Company name. Billify matches an existing client by this name, without case. |
| main_contact_name | string | Main contact person. |
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.
| Parameter | Type | Description |
|---|---|---|
| status | string | Only offers with this status. |
| client_id | integer | Only records of this client id. |
{
"name": "billify_list_offers",
"title": "List offers",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"status": {
"enum": [
"DRAFT",
"SENT",
"ACCEPTED",
"REJECTED",
"EXPIRED",
"CONVERTED"
],
"type": "string",
"description": "Only offers with this status."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only records of this client id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List offers",
"readOnlyHint": true
}
}Get one offer by id, with its line items, status, amounts and dates. Billify API: GET /api/v1/offers/{id}.
| Parameter | Type | Description |
|---|---|---|
| offer_id * | integer | Offer id. |
{
"name": "billify_get_offer",
"title": "Get an offer",
"description": "Get one offer by id, with its line items, status, amounts and dates. Billify API: GET /api/v1/offers/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"offer_id"
],
"properties": {
"offer_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Offer id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an offer",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| items * | array | Line items, in order. Billify computes each total. |
| notes | string | Remarks printed on the offer. |
| title * | string | Offer title. |
| currency | string | CHF or EUR. Omit for CHF. |
| discount | number | Discount. Send together with discount_type. |
| language | string | Document language. Omit to use the client's language. |
| vat_rate | any | VAT rate in percent: 8.1, 2.6, 3.8 or 0. Omit for 8.1 (0 for companies without VAT). |
| client_id * | integer | Client id. |
| offer_date | string | Offer date, YYYY-MM-DD. Omit for today. |
| valid_until |
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.
| Parameter | Type | Description |
|---|---|---|
| status | string | Only invoices with this status. |
| client_id | integer | Only records of this client id. |
{
"name": "billify_list_invoices",
"title": "List invoices",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"status": {
"enum": [
"DRAFT",
"OPEN",
"PARTIALLY_PAID",
"PAID",
"OVERDUE",
"CANCELLED"
],
"type": "string",
"description": "Only invoices with this status."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only records of this client id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true
}
}Get one invoice by id, with its line items, status, dates, amounts, payment status and QR reference. Billify API: GET /api/v1/invoices/{id}.
| Parameter | Type | Description |
|---|---|---|
| invoice_id * | integer | Invoice id. |
{
"name": "billify_get_invoice",
"title": "Get an invoice",
"description": "Get one invoice by id, with its line items, status, dates, amounts, payment status and QR reference. Billify API: GET /api/v1/invoices/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id"
],
"properties": {
"invoice_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Invoice id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an invoice",
"readOnlyHint": true
}
}Tools for Billify, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which clients in Billify have an offer that is still open?"; "Create an offer for Muster Gartenbau: 12 months of garden care at CHF 180 per month."; "Show me the overdue invoices and their amounts.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Billify data. Free plan: 50 tool calls per month. Run billify_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run billify_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run billify_upgrade without a plan: it returns both plans, each with a payment link for the user to open. billify_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| main_contact_email | string | Main contact email address. |
| main_contact_phone | string | Main contact phone number. |
{
"name": "billify_create_client",
"title": "Create a client",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"company_name"
],
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"description": "City."
},
"notes": {
"type": "string",
"maxLength": 5000,
"description": "Internal notes. Not shown to the client."
},
"address": {
"type": "string",
"maxLength": 300,
"description": "Street and number."
},
"country": {
"type": "string",
"maxLength": 100,
"description": "Country, for example Schweiz."
},
"website": {
"type": "string",
"maxLength": 500,
"description": "Website."
},
"industry": {
"type": "string",
"maxLength": 100,
"description": "Industry."
},
"language": {
"enum": [
"de",
"en",
"fr",
"it"
],
"type": "string",
"description": "Language of the client's documents. Omit to use the company language."
},
"postal_code": {
"type": "string",
"maxLength": 20,
"description": "Postal code."
},
"company_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Company name. Billify matches an existing client by this name, without case."
},
"main_contact_name": {
"type": "string",
"maxLength": 200,
"description": "Main contact person."
},
"main_contact_email": {
"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,}$",
"description": "Main contact email address."
},
"main_contact_phone": {
"type": "string",
"maxLength": 50,
"description": "Main contact phone number."
}
}
},
"annotations": {
"title": "Create a client",
"destructiveHint": true
}
}| string |
| Offer valid until, YYYY-MM-DD. |
| billing_type | string | ONE_TIME, or MONTHLY for recurring billing. |
| discount_type | string | PERCENT (at most 100) or AMOUNT. |
| billing_months | integer | Number of months. Only with billing_type MONTHLY. |
{
"name": "billify_create_offer",
"title": "Create an offer",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id",
"title",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"unit_price"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 50,
"description": "Unit, for example Stk, Std. or Pauschale. Omit for Stk."
},
"details": {
"type": "string",
"maxLength": 5000,
"description": "Text under the line item name."
},
"quantity": {
"type": "number",
"description": "Quantity. Omit for 1.",
"exclusiveMinimum": 0
},
"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."
},
"description": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Line item name."
}
}
},
"maxItems": 200,
"minItems": 1,
"description": "Line items, in order. Billify computes each total."
},
"notes": {
"type": "string",
"maxLength": 5000,
"description": "Remarks printed on the offer."
},
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Offer title."
},
"currency": {
"enum": [
"CHF",
"EUR"
],
"type": "string",
"description": "CHF or EUR. Omit for CHF."
},
"discount": {
"type": "number",
"minimum": 0,
"description": "Discount. Send together with discount_type."
},
"language": {
"enum": [
"de",
"en",
"fr",
"it"
],
"type": "string",
"description": "Document language. Omit to use the client's language."
},
"vat_rate": {
"anyOf": [
{
"type": "number",
"const": 8.1
},
{
"type": "number",
"const": 2.6
},
{
"type": "number",
"const": 3.8
},
{
"type": "number",
"const": 0
}
],
"description": "VAT rate in percent: 8.1, 2.6, 3.8 or 0. Omit for 8.1 (0 for companies without VAT)."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Client id.",
"exclusiveMinimum": 0
},
"offer_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Offer date, YYYY-MM-DD. Omit for today."
},
"valid_until": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Offer valid until, YYYY-MM-DD."
},
"billing_type": {
"enum": [
"ONE_TIME",
"MONTHLY"
],
"type": "string",
"description": "ONE_TIME, or MONTHLY for recurring billing."
},
"discount_type": {
"enum": [
"PERCENT",
"AMOUNT"
],
"type": "string",
"description": "PERCENT (at most 100) or AMOUNT."
},
"billing_months": {
"type": "integer",
"maximum": 120,
"minimum": 1,
"description": "Number of months. Only with billing_type MONTHLY."
}
}
},
"annotations": {
"title": "Create an offer",
"destructiveHint": true
}
}