Briox MCP by usefulapi
Read invoices, journals and accounts; create customers, items and unposted invoices in Briox.
¿Debería usar esto?
Calidad y seguridad
A
Hallazgos (1)
- LOWTool 'briox_get_bank_account_balances' name length outside 3-30 rangeen briox_get_bank_account_balances
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~4,994Tokens (definiciones de herramientas)
~1.6 KBTamaño de respuesta típico
Impacto significativo en la atención (3.90% 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": {
"briox": {
"url": "https://briox.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://briox.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (25)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢briox_get_company_info
The Briox company the connection belongs to: name, address, bank details, organization number and more. Good first call. GET /company/info.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_customers(company_number, modified_since, order_by, order_direction, page, ...)
List customers (custno, name, address, e-mail, phone, company number, active flag). Paged: pass next_page as page. GET /customer.
Esquema de entrada
{
"type": "object",
"properties": {
"company_number": {
"description": "Only the customer with this company (organization) number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"modified_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2})?$",
"description": "Only objects modified after this moment: yyyy-mm-dd or 'yyyy-mm-dd HH:MM'."
},
"order_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"id",
"name",
"modified"
]
},
"order_direction": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (the first page is 1). Use next_page from the previous reply.",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_suppliers(company_number, page, limit)
List suppliers (supplierno, name, address, e-mail, company number). Paged: pass next_page as page. GET /supplier.
Esquema de entrada
{
"type": "object",
"properties": {
"company_number": {
"description": "Only the supplier with this company (organization) number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"page": {
"description": "Page number (the first page is 1). Use next_page from the previous reply.",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_customer_invoices(from_date, to_date, modified_since, status, type, ...)
List customer (sales) invoices with total, saldo (open amount), invoice and due date, customer. Filter by date range, status (for example overdue, unsettled, finalpayed) and type. Paged: pass next_page as page. GET /customerinvoice.
Esquema de entrada
{
"type": "object",
"properties": {
"from_date": {
"description": "Invoices dated on or after this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to_date": {
"description": "Invoices dated on or before this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"modified_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2})?$",
"description": "Only objects modified after this moment: yyyy-mm-dd or 'yyyy-mm-dd HH:MM'."
},
"status": {
"description": "Status filter (default all): unsettled = not fully paid, overdue = past due date, finalpayed = fully paid.",
"type": "string",
"enum": [
"all",
"unposted",
"notcancelled",
"unsettled",
"overdue",
"notpayedoverdue",
"finalpayed",
"cancel",
"paypend",
"notpaypend",
"paypendoverdue",
"debtcollection"
]
},
"type": {
"description": "Invoice type (Briox default: invoice).",
"type": "string",
"enum": [
"invoice",
"cashinvoice"
]
},
"order_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"id",
"name",
"modified"
]
},
"order_direction": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (the first page is 1). Use next_page from the previous reply.",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_supplier_invoices(from_date, to_date, modified_since, order_by, order_direction, ...)
List supplier (purchase) invoices with total, saldo, payment status, invoice and payment date, supplier. Filter by date range. Paged: pass next_page as page. GET /supplierinvoice.
Esquema de entrada
{
"type": "object",
"properties": {
"from_date": {
"description": "Invoices dated on or after this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to_date": {
"description": "Invoices dated on or before this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"modified_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2})?$",
"description": "Only objects modified after this moment: yyyy-mm-dd or 'yyyy-mm-dd HH:MM'."
},
"order_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"id",
"name",
"modified"
]
},
"order_direction": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (the first page is 1). Use next_page from the previous reply.",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_items(supplier_item_number, manufacturer_item_number, modified_since, order_by, order_direction, ...)
List items (products and services) with description, unit, type, prices, VAT rate and stock. Paged: pass next_page as page. GET /item.
Esquema de entrada
{
"type": "object",
"properties": {
"supplier_item_number": {
"description": "Only items with this supplier item number.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"manufacturer_item_number": {
"description": "Only items with this manufacturer item number.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"modified_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2})?$",
"description": "Only objects modified after this moment: yyyy-mm-dd or 'yyyy-mm-dd HH:MM'."
},
"order_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"id",
"name",
"modified"
]
},
"order_direction": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (the first page is 1). Use next_page from the previous reply.",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_get_customer(customer_id)
One customer with addresses, payment terms, VAT number, delivery methods and defaults. GET /customer/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The customer id (the customer number, custno, from briox_list_customers)."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_get_supplier(supplier_id)
One supplier with addresses, bank details, payment terms and defaults. GET /supplier/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"supplier_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The supplier id (supplierno from briox_list_suppliers)."
}
},
"required": [
"supplier_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_get_customer_invoice(invoice_id)
One customer invoice with rows, totals, saldo, payment and reminder state. GET /customerinvoice/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The customer invoice id (id from briox_list_customer_invoices)."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_get_supplier_invoice(invoice_id)
One supplier invoice with rows, totals, payment status, linked files and deviations. GET /supplierinvoice/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The supplier invoice id (id from briox_list_supplier_invoices)."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_get_item(item_id)
One item (article) with prices, VAT rate, accounts, stock and supplier data. GET /item/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"item_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The item number (item_id from briox_list_items)."
}
},
"required": [
"item_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_accounts(year, active, page, limit)
List ledger accounts with description, VAT code, active flag and incoming balance for a financial year. Paged: pass next_page as page. GET /account.
Esquema de entrada
{
"type": "object",
"properties": {
"year": {
"description": "The financial year id from briox_list_financial_years.",
"type": "string",
"pattern": "^\\d{1,6}$"
},
"active": {
"description": "true = only active accounts, false = only inactive.",
"type": "boolean"
},
"page": {
"description": "Page number (the first page is 1). Use next_page from the previous reply.",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_financial_years
List the financial years (id, from and to date, accounting method). The id is the financial year argument of the journal tools. GET /financialyear.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_journal_series(financial_year)
List the journal series of a financial year (for example A, B). GET /journal/series/{financialyear}.
Esquema de entrada
{
"type": "object",
"properties": {
"financial_year": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "The financial year id from briox_list_financial_years."
}
},
"required": [
"financial_year"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_journals(financial_year, series, from_date, to_date, page, ...)
List journal entries (vouchers with their debit/credit rows) of a financial year, optionally of one series and a date range. Paged: pass next_page as page. GET /journal/{financialyear}[/{series}].
Esquema de entrada
{
"type": "object",
"properties": {
"financial_year": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "The financial year id from briox_list_financial_years."
},
"series": {
"description": "Only this journal series (briox_list_journal_series).",
"type": "string",
"minLength": 1,
"maxLength": 20
},
"from_date": {
"description": "Entries on or after this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to_date": {
"description": "Entries on or before this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"page": {
"description": "Page number (the first page is 1). Use next_page from the previous reply.",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"required": [
"financial_year"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_get_journal(financial_year, series, journal_id)
One journal entry with all its debit/credit rows. GET /journal/{financialyear}/{series}/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"financial_year": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "The financial year id from briox_list_financial_years."
},
"series": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "The journal series (for example A)."
},
"journal_id": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "The journal id (id from briox_list_journals)."
}
},
"required": [
"financial_year",
"series",
"journal_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_get_bank_account_balances
The balances of the company's bank accounts. GET /bank/accountbalance.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_vat_codes
List VAT codes with description and percentage. GET /vatcode.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_payment_terms
List payment terms (the ids usable on customers and invoices). GET /payment/term.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_projects(page, limit)
List projects with leader, status, dates and customers. Paged: pass next_page as page. GET /project.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"description": "Page number (the first page is 1). Use next_page from the previous reply.",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_cost_centers(page, limit)
List cost centers (code, text, active). Paged: pass next_page as page. GET /costcenter.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"description": "Page number (the first page is 1). Use next_page from the previous reply.",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢briox_list_sales_orders(from_date, to_date, status, page, limit)
List sales orders, optionally by date range and status. Paged: pass next_page as page. GET /salesorder.
Esquema de entrada
{
"type": "object",
"properties": {
"from_date": {
"description": "Orders dated on or after this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to_date": {
"description": "Orders dated on or before this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"status": {
"description": "Status filter (default all).",
"type": "string",
"enum": [
"all",
"expired",
"billed",
"notbilled",
"notbilledanddelivered",
"workinprogress",
"cancel"
]
},
"page": {
"description": "Page number (the first page is 1). Use next_page from the previous reply.",
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡briox_create_customer(custno, name, is_company, email, phone, ...)
Create a customer in Briox (the customer number custno is assigned by you; use a free number). Creates a new record; it never changes an existing one. POST /customer.
Esquema de entrada
{
"type": "object",
"properties": {
"custno": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Customer number (must be unused)."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Customer name."
},
"is_company": {
"description": "true = company, false = private person.",
"type": "boolean"
},
"email": {
"type": "string",
"maxLength": 255
},
"phone": {
"type": "string",
"maxLength": 60
},
"company_number": {
"description": "Company (organization) number.",
"type": "string",
"maxLength": 40
},
"vat_number": {
"description": "VAT number starting with the 2-letter country code.",
"type": "string",
"maxLength": 14
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"payment_terms": {
"description": "Payment term id from briox_list_payment_terms.",
"type": "string",
"maxLength": 50
},
"description": {
"description": "Free text note.",
"type": "string",
"maxLength": 1024
},
"address": {
"description": "Invoice address, street line.",
"type": "string",
"maxLength": 255
},
"zip": {
"type": "string",
"maxLength": 20
},
"city": {
"type": "string",
"maxLength": 100
},
"country_code": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"required": [
"custno",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡briox_create_item(item_id, description, type, unit, sales_account, ...)
Create an item (a product or service) in Briox. Prices are set in Briox afterwards. Creates a new record only. POST /item.
Esquema de entrada
{
"type": "object",
"properties": {
"item_id": {
"description": "Item number; Briox picks the next free one when omitted.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Item description (max 50 characters)."
},
"type": {
"description": "Goods or Service.",
"type": "string",
"enum": [
"Goods",
"Service"
]
},
"unit": {
"description": "Unit, for example st, h, each.",
"type": "string",
"maxLength": 20
},
"sales_account": {
"description": "Sales account, for example 3001.",
"type": "string",
"pattern": "^\\d{3,10}$"
},
"vat_rate": {
"description": "VAT rate in percent, for example 25.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"long_description": {
"type": "string",
"maxLength": 2000
},
"notes": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"description"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡briox_create_customer_invoice(customer_id, invoice_date, due_date, currency, payment_term, ...)
Create a customer invoice that is NOT posted (post=false): it is saved for review and the user posts and sends it in Briox. Needs an existing customer and at least one row. POST /customerinvoice.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The customer number (custno) from briox_list_customers."
},
"invoice_date": {
"description": "Invoice date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"due_date": {
"description": "Due date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"payment_term": {
"description": "Payment term id from briox_list_payment_terms.",
"type": "string",
"maxLength": 50
},
"your_reference": {
"type": "string",
"maxLength": 255
},
"our_reference": {
"type": "string",
"maxLength": 255
},
"invoice_text": {
"description": "Text shown on the invoice.",
"type": "string",
"maxLength": 1024
},
"rows": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Row text (max 50 characters)."
},
"amount": {
"type": "number",
"minimum": -1000000000000,
"maximum": 1000000000000,
"description": "Quantity."
},
"price": {
"type": "number",
"minimum": -1000000000000,
"maximum": 1000000000000,
"description": "Unit price excluding VAT."
},
"itemno": {
"description": "Item number from briox_list_items.",
"type": "string",
"maxLength": 50
},
"unit": {
"type": "string",
"maxLength": 20
},
"account": {
"description": "Sales account for the row.",
"type": "string",
"pattern": "^\\d{3,10}$"
}
},
"required": [
"description",
"amount",
"price"
]
},
"description": "Invoice rows."
}
},
"required": [
"customer_id",
"rows"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada25 herramientas