Billogram MCP by usefulapi is an MCP server published by io.usefulapi, hosted at billogram.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 12 tools, including billogram_list_invoices, billogram_get_invoice, billogram_list_invoice_events, billogram_list_customers, billogram_get_customer.
Read invoices, customers, items and balances; create invoices, customers and items in Billogram.
4,052 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Result page, from 1 (default 1). |
| page_size | integer | Results per page, 1-100 (default 25). |
| filter_type | string | How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value. |
| order_field | string | Field to sort by, for example created_at. Needs order_direction. |
| filter_field | string | Field to filter on, for example state, or nested as customer:name. |
| filter_value | string | Value to match. |
| order_direction | string | Sort direction. Needs order_field. |
{
"name": "billogram_list_invoices",
"title": "List invoices",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Result page, from 1 (default 1)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"filter_type": {
"enum": [
"field",
"field-prefix",
"field-search"
],
"type": "string",
"description": "How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value."
},
"order_field": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Field to sort by, for example created_at. Needs order_direction."
},
"filter_field": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Field to filter on, for example state, or nested as customer:name."
},
"filter_value": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Value to match."
},
"order_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction. Needs order_field."
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Fetch one invoice with its customer, items, totals, state, dates and registered payments. GET /billogram/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Invoice id (the id field of an invoice, for example 2kAEEjE). |
{
"name": "billogram_get_invoice",
"title": "Get invoice",
"description": "Fetch one invoice with its customer, items, totals, state, dates and registered payments. GET /billogram/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 64,
"minLength": 1,
"description": "Invoice id (the id field of an invoice, for example 2kAEEjE)."
}
}
},
"annotations": {
"title": "Get invoice",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List invoice events (the history of changes, such as sent, paid or reminded) as Billogram returns them. Optional filter and sort. GET /billogram_event.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Result page, from 1 (default 1). |
| page_size | integer | Results per page, 1-100 (default 25). |
| filter_type | string | How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value. |
| order_field | string | Field to sort by, for example created_at. Needs order_direction. |
| filter_field | string | Field to filter on, for example state, or nested as customer:name. |
| filter_value | string | Value to match. |
| order_direction | string | Sort direction. Needs order_field. |
{
"name": "billogram_list_invoice_events",
"title": "List invoice events",
"description": "List invoice events (the history of changes, such as sent, paid or reminded) as Billogram returns them. Optional filter and sort. GET /billogram_event.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Result page, from 1 (default 1)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"filter_type": {
"enum": [
"field",
"field-prefix",
"field-search"
],
"type": "string",
"description": "How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value."
},
"order_field": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Field to sort by, for example created_at. Needs order_direction."
},
"filter_field": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Field to filter on, for example state, or nested as customer:name."
},
"filter_value": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Value to match."
},
"order_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction. Needs order_field."
}
}
},
"annotations": {
"title": "List invoice events",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List customers with number, name, organisation and VAT number, contact, addresses and payment settings. Optional filter and sort. GET /customer.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Result page, from 1 (default 1). |
| page_size | integer | Results per page, 1-100 (default 25). |
| filter_type | string | How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value. |
| order_field | string | Field to sort by, for example created_at. Needs order_direction. |
| filter_field | string | Field to filter on, for example state, or nested as customer:name. |
| filter_value | string | Value to match. |
| order_direction | string | Sort direction. Needs order_field. |
{
"name": "billogram_list_customers",
"title": "List customers",
"description": "List customers with number, name, organisation and VAT number, contact, addresses and payment settings. Optional filter and sort. GET /customer.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Result page, from 1 (default 1)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"filter_type": {
"enum": [
"field",
"field-prefix",
"field-search"
],
"type": "string",
"description": "How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value."
},
"order_field": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Field to sort by, for example created_at. Needs order_direction."
},
"filter_field": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Field to filter on, for example state, or nested as customer:name."
},
"filter_value": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Value to match."
},
"order_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction. Needs order_field."
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Fetch one customer by customer number: contact, addresses, e-invoice details and payment settings. GET /customer/{customer_no}.
| Parameter | Type | Description |
|---|---|---|
| customer_no * | integer | Customer number (customer_no). |
{
"name": "billogram_get_customer",
"title": "Get customer",
"description": "Fetch one customer by customer number: contact, addresses, e-invoice details and payment settings. GET /customer/{customer_no}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_no"
],
"properties": {
"customer_no": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Customer number (customer_no).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get customer",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Fetch the balance of one customer by customer number (the amount they owe). GET /customer/{customer_no}/balance.
| Parameter | Type | Description |
|---|---|---|
| customer_no * | integer | Customer number (customer_no). |
{
"name": "billogram_get_customer_balance",
"title": "Get customer balance",
"description": "Fetch the balance of one customer by customer number (the amount they owe). GET /customer/{customer_no}/balance.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_no"
],
"properties": {
"customer_no": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Customer number (customer_no).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get customer balance",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List saved items (products and services) with item number, title, price, VAT, unit and bookkeeping accounts. Optional filter and sort. GET /item.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Result page, from 1 (default 1). |
| page_size | integer | Results per page, 1-100 (default 25). |
| filter_type | string | How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value. |
| order_field | string | Field to sort by, for example created_at. Needs order_direction. |
| filter_field | string | Field to filter on, for example state, or nested as customer:name. |
| filter_value | string | Value to match. |
| order_direction | string | Sort direction. Needs order_field. |
{
"name": "billogram_list_items",
"title": "List items",
"description": "List saved items (products and services) with item number, title, price, VAT, unit and bookkeeping accounts. Optional filter and sort. GET /item.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Result page, from 1 (default 1)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"filter_type": {
"enum": [
"field",
"field-prefix",
"field-search"
],
"type": "string",
"description": "How to match filter_value: exact (field), starts with (field-prefix) or contains (field-search). Needs filter_field and filter_value."
},
"order_field": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Field to sort by, for example created_at. Needs order_direction."
},
"filter_field": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Field to filter on, for example state, or nested as customer:name."
},
"filter_value": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Value to match."
},
"order_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction. Needs order_field."
}
}
},
"annotations": {
"title": "List items",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Fetch one saved item by item number. GET /item/{item_no}.
| Parameter | Type | Description |
|---|---|---|
| item_no * | string | Item number (item_no) of a saved item. |
{
"name": "billogram_get_item",
"title": "Get item",
"description": "Fetch one saved item by item number. GET /item/{item_no}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"item_no"
],
"properties": {
"item_no": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Item number (item_no) of a saved item."
}
}
},
"annotations": {
"title": "Get item",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Fetch the account settings: company details, default due days, currency and invoice defaults. GET /settings.
No parameters.
{
"name": "billogram_get_settings",
"title": "Get settings",
"description": "Fetch the account settings: company details, default due days, currency and invoice defaults. GET /settings.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get settings",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Create a customer. Only the fields you pass are set. Creates a new customer record each time (it is not idempotent). POST /customer.
| Parameter | Type | Description |
|---|---|---|
| city | string | City. |
| name * | string | Customer name. |
| string | Contact e-mail. | |
| phone | string | Contact phone. |
| org_no | string | Organisation number. |
| vat_no | string | VAT number. |
| country | string | Country code, for example SE. |
| zipcode | string | Postal code. |
| contact_name | string | Contact person. |
| street_address | string | Street address. |
Create a saved item (product or service) for later invoices. Creates a new item each time (it is not idempotent). POST /item.
| Parameter | Type | Description |
|---|---|---|
| vat * | number | VAT rate number, for example 25. |
| unit * | string | Unit, for example pcs or hour. |
| price * | number | Unit price. |
| title * | string | Item title. |
| item_no | string | Item number to give the item. |
| description | string | Longer description. |
{
"name": "billogram_create_item",
"title": "Create item",
"description": "Create a saved item (product or service) for later invoices. Creates a new item each time (it is not idempotent). POST /item.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title",
"price",
"vat",
"unit"
],
"properties": {
"vat": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "VAT rate number, for example 25."
},
"unit": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Unit, for example pcs or hour."
},
"price": {
"type": "number",
"maximum": 1000000000,
"minimum": -1000000000,
"description": "Unit price."
},
"title": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Item title."
},
"item_no": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Item number to give the item."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Longer description."
}
}
},
"annotations": {
"title": "Create item",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| items * | array | Invoice lines (1-100). |
| currency | string | ISO currency code, for example SEK. |
| due_date | string | Due date, YYYY-MM-DD. Omit to use due_days or the account default. |
| due_days | integer | Days from the invoice date to the due date. |
| customer_no * | integer | Customer number (customer_no). |
| invoice_date | string | Invoice date, YYYY-MM-DD. Omit to use Billogram's default. |
{
"name": "billogram_create_invoice",
"title": "Create invoice",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_no",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"count",
"price"
],
"properties": {
"vat": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "VAT rate number, for example 25. Omit to use the account default."
},
"unit": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Unit, for example pcs or hour."
},
"count": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Quantity."
},
"price": {
"type": "number",
"maximum": 1000000000,
"minimum": -1000000000,
"description": "Unit price, in the invoice currency."
},
"title": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Text of the invoice line."
},
"item_no": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Item number of a saved item, if the line uses one."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Longer description of the line."
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "Invoice lines (1-100)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO currency code, for example SEK."
},
"due_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Due date, YYYY-MM-DD. Omit to use due_days or the account default."
},
"due_days": {
"type": "integer",
"maximum": 365,
"minimum": 0,
"description": "Days from the invoice date to the due date."
},
"customer_no": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Customer number (customer_no).",
"exclusiveMinimum": 0
},
"invoice_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Invoice date, YYYY-MM-DD. Omit to use Billogram's default."
}
}
},
"annotations": {
"title": "Create invoice",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Tools for Billogram, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which invoices are still unpaid, and what is the total remaining?"; "Show customer 1042 with its current balance."; "Create a draft invoice for customer 1042 with 3 hours of consulting at 1200 SEK each.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Billogram data. Free plan: 50 tool calls per month. Run billogram_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run billogram_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run billogram_upgrade without a plan: it returns both plans, each with a payment link for the user to open. billogram_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "billogram_create_customer",
"title": "Create customer",
"description": "Create a customer. Only the fields you pass are set. Creates a new customer record each time (it is not idempotent). POST /customer.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "City."
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Customer name."
},
"email": {
"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,}$",
"maxLength": 254,
"description": "Contact e-mail."
},
"phone": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Contact phone."
},
"org_no": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Organisation number."
},
"vat_no": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "VAT number."
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "Country code, for example SE."
},
"zipcode": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "Postal code."
},
"contact_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Contact person."
},
"street_address": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Street address."
}
}
},
"annotations": {
"title": "Create customer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}