Billutant MCP by usefulapi
Read invoices, customers, items and templates; create and send invoices in Billutant.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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-httpWhat it can do
Tool inventory
Tools (10)
🟢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
Evidence