Billify MCP by usefulapi

Read clients, offers and invoices; create clients and offer drafts in Billify.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
96%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,012Tokens (tool definitions)
~1.9 KBTypical response size
Moderate attention impact (1.57% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "billify": {
      "url": "https://billify.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://billify.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (8)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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.

Input Schema

{
  "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}.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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}.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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}.

Input Schema

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

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded8 tools