Billogram MCP by usefulapi

Read invoices, customers, items and balances; create invoices, customers and items in Billogram.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
98%
Integridad del esquema
91%
Calidad de los nombres
80%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~3,101Tokens (definiciones de herramientas)
~2.1 KBTamaño de respuesta típico
Impacto significativo en la atención (2.42% del contexto de 128k)

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-http

Qué puede hacer

Inventario de herramientas

Herramientas (12)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada12 herramientas