Billogram MCP by usefulapi
Read invoices, customers, items and balances; create invoices, customers and items in Billogram.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"billogram": {
"url": "https://billogram.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://billogram.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (12)
🟢billogram_list_invoices(page, page_size, filter_type, filter_field, filter_value, ...)
List invoices (Billogram calls them billograms): invoice number, customer, dates, state, totals and remaining sum. Optional filter and sort. Use an id from the reply with billogram_get_invoice. GET /billogram.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"description": "Result page, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"filter_type": {
"description": "How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value.",
"type": "string",
"enum": [
"field",
"field-prefix",
"field-search"
]
},
"filter_field": {
"description": "Field to filter on, for example state, or nested as customer:name.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"filter_value": {
"description": "Value to match.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"order_field": {
"description": "Field to sort by, for example created_at. Needs order_direction.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"order_direction": {
"description": "Sort direction. Needs order_field.",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billogram_get_invoice(id)
Fetch one invoice with its customer, items, totals, state, dates and registered payments. GET /billogram/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Invoice id (the id field of an invoice, for example 2kAEEjE)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billogram_list_invoice_events(page, page_size, filter_type, filter_field, filter_value, ...)
List invoice events (the history of changes, such as sent, paid or reminded) as Billogram returns them. Optional filter and sort. GET /billogram_event.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"description": "Result page, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"filter_type": {
"description": "How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value.",
"type": "string",
"enum": [
"field",
"field-prefix",
"field-search"
]
},
"filter_field": {
"description": "Field to filter on, for example state, or nested as customer:name.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"filter_value": {
"description": "Value to match.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"order_field": {
"description": "Field to sort by, for example created_at. Needs order_direction.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"order_direction": {
"description": "Sort direction. Needs order_field.",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billogram_list_customers(page, page_size, filter_type, filter_field, filter_value, ...)
List customers with number, name, organisation and VAT number, contact, addresses and payment settings. Optional filter and sort. GET /customer.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"description": "Result page, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"filter_type": {
"description": "How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value.",
"type": "string",
"enum": [
"field",
"field-prefix",
"field-search"
]
},
"filter_field": {
"description": "Field to filter on, for example state, or nested as customer:name.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"filter_value": {
"description": "Value to match.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"order_field": {
"description": "Field to sort by, for example created_at. Needs order_direction.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"order_direction": {
"description": "Sort direction. Needs order_field.",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billogram_get_customer(customer_no)
Fetch one customer by customer number: contact, addresses, e-invoice details and payment settings. GET /customer/{customer_no}.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_no": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Customer number (customer_no)."
}
},
"required": [
"customer_no"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billogram_get_customer_balance(customer_no)
Fetch the balance of one customer by customer number (the amount they owe). GET /customer/{customer_no}/balance.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_no": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Customer number (customer_no)."
}
},
"required": [
"customer_no"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billogram_list_items(page, page_size, filter_type, filter_field, filter_value, ...)
List saved items (products and services) with item number, title, price, VAT, unit and bookkeeping accounts. Optional filter and sort. GET /item.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"description": "Result page, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"filter_type": {
"description": "How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value.",
"type": "string",
"enum": [
"field",
"field-prefix",
"field-search"
]
},
"filter_field": {
"description": "Field to filter on, for example state, or nested as customer:name.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"filter_value": {
"description": "Value to match.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"order_field": {
"description": "Field to sort by, for example created_at. Needs order_direction.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"order_direction": {
"description": "Sort direction. Needs order_field.",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billogram_get_item(item_no)
Fetch one saved item by item number. GET /item/{item_no}.
Esquema de entrada
{
"type": "object",
"properties": {
"item_no": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Item number (item_no) of a saved item."
}
},
"required": [
"item_no"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢billogram_get_settings
Fetch the account settings: company details, default due days, currency and invoice defaults. GET /settings.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴billogram_create_customer(name, org_no, vat_no, contact_name, email, ...)
Create a customer. Only the fields you pass are set. Creates a new customer record each time (it is not idempotent). POST /customer.
Esquema de entrada
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Customer name."
},
"org_no": {
"description": "Organisation number.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"vat_no": {
"description": "VAT number.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"contact_name": {
"description": "Contact person.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"description": "Contact e-mail.",
"type": "string",
"maxLength": 254,
"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,}$"
},
"phone": {
"description": "Contact phone.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"street_address": {
"description": "Street address.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"zipcode": {
"description": "Postal code.",
"type": "string",
"minLength": 1,
"maxLength": 20
},
"city": {
"description": "City.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"country": {
"description": "Country code, for example SE.",
"type": "string",
"minLength": 2,
"maxLength": 2
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴billogram_create_item(title, price, vat, unit, description, ...)
Create a saved item (product or service) for later invoices. Creates a new item each time (it is not idempotent). POST /item.
Esquema de entrada
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Item title."
},
"price": {
"type": "number",
"minimum": -1000000000,
"maximum": 1000000000,
"description": "Unit price."
},
"vat": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "VAT rate number, for example 25."
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Unit, for example pcs or hour."
},
"description": {
"description": "Longer description.",
"type": "string",
"maxLength": 2000
},
"item_no": {
"description": "Item number to give the item.",
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"title",
"price",
"vat",
"unit"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴billogram_create_invoice(customer_no, items, invoice_date, due_date, due_days, ...)
Create an invoice (a Billogram billogram) for an existing customer. The invoice is created only: this server does not send it, and sending is a separate Billogram command that is not exposed. Creates a new invoice each time (it is not idempotent). POST /billogram.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_no": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Customer number (customer_no)."
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Text of the invoice line."
},
"count": {
"type": "number",
"minimum": 0,
"maximum": 1000000,
"description": "Quantity."
},
"price": {
"type": "number",
"minimum": -1000000000,
"maximum": 1000000000,
"description": "Unit price, in the invoice currency."
},
"vat": {
"description": "VAT rate number, for example 25. Omit to use the account default.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"unit": {
"description": "Unit, for example pcs or hour.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"description": {
"description": "Longer description of the line.",
"type": "string",
"maxLength": 2000
},
"item_no": {
"description": "Item number of a saved item, if the line uses one.",
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"title",
"count",
"price"
]
},
"description": "Invoice lines (1-100)."
},
"invoice_date": {
"description": "Invoice date, YYYY-MM-DD. Omit to use Billogram's default.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"due_date": {
"description": "Due date, YYYY-MM-DD. Omit to use due_days or the account default.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"due_days": {
"description": "Days from the invoice date to the due date.",
"type": "integer",
"minimum": 0,
"maximum": 365
},
"currency": {
"description": "ISO currency code, for example SEK.",
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"required": [
"customer_no",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia