Billutant MCP by usefulapi

Read invoices, customers, items and templates; create and send invoices in Billutant.

Should I use this

Quality & Safety

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

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,227Tokens (tool definitions)
~653 BTypical response size
Moderate attention impact (0.96% 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": {
    "billutant": {
      "url": "https://billutant.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

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

What it can do

Tool inventory

Tools (10)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢billutant_list_invoices

List the invoices of the connected Billutant account, with number, status, customer id and sent state. Billutant API: GET /invoices.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢billutant_get_invoice(invoice_id)

Get one invoice by id, including its number, status, files and sent state. Billutant API: GET /invoices/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string",
      "minLength": 1,
      "description": "The invoice id."
    }
  },
  "required": [
    "invoice_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢billutant_list_customers

List the customers of the connected Billutant account. Use their ids in billutant_create_invoice. Billutant API: GET /customers.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢billutant_get_customer(customer_id)

Get one customer by id. Billutant API: GET /customers/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "string",
      "minLength": 1,
      "description": "The customer id."
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢billutant_list_items

List the products and services (items) that Billutant uses as invoice lines. Use their ids in billutant_create_invoice. Billutant API: GET /items.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢billutant_get_item(item_id)

Get one product or service (item) by id, with its name, price, tax and unit. Billutant API: GET /items/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "minLength": 1,
      "description": "The item id."
    }
  },
  "required": [
    "item_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢billutant_list_email_templates

List the e-mail templates used when Billutant sends an invoice. Use their ids as email_template_id. Billutant API: GET /email-templates.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢billutant_get_email_template(template_id)

Get one e-mail template by id, with its type, label, subject and body. Billutant API: GET /email-templates/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "template_id": {
      "type": "string",
      "minLength": 1,
      "description": "The e-mail template id."
    }
  },
  "required": [
    "template_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴billutant_create_invoice(customer_id, item_ids, draft, send, email_template_id)

Create an invoice for an existing customer from existing item ids. Billutant sets the invoice date and number, and each call uses the next number in the sequence. draft=true saves a draft and sends nothing. send=true e-mails the customer and needs email_template_id; draft and send cannot both be true. Billutant API: POST /invoices.

Input Schema

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "string",
      "minLength": 1,
      "description": "The customer id."
    },
    "item_ids": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "One or more item ids, in invoice line order."
    },
    "draft": {
      "description": "true = save as a draft (no number is final, nothing is sent).",
      "type": "boolean"
    },
    "send": {
      "description": "true = e-mail the invoice to the customer now (needs email_template_id).",
      "type": "boolean"
    },
    "email_template_id": {
      "description": "E-mail template id (from billutant_list_email_templates). Required when send is true.",
      "type": "string"
    }
  },
  "required": [
    "customer_id",
    "item_ids"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴billutant_send_invoice(invoice_id, email_template_id)

E-mail an existing invoice that is not a draft to its customer, using an e-mail template. This sends mail to a real customer and cannot be undone. Billutant API: POST /invoices/{id}/send.

Input Schema

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string",
      "minLength": 1,
      "description": "The invoice id."
    },
    "email_template_id": {
      "type": "string",
      "minLength": 1,
      "description": "E-mail template id (from billutant_list_email_templates)."
    }
  },
  "required": [
    "invoice_id",
    "email_template_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded10 tools