Conta MCP by usefulapi
Read customers, invoices, payments, ledgers and reports; create customers in Conta.
¿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": {
"conta": {
"url": "https://conta.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://conta.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (16)
🟢conta_list_organizations
List the organizations (businesses) the API key's user can access, with their ids. Call this first to get the organizationId every other tool needs. Conta API: GET /invoice/organizations.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_search_customers(organizationId, q, page, hits, sort, ...)
Search customers of an organization by free text (name, number, e-mail), or list them, with optional modified-date range. Conta API: GET /invoice/organizations/{organizationId}/customers.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"q": {
"description": "Partial-word search across the main fields.",
"type": "string"
},
"page": {
"description": "Page number, starting at 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"hits": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
},
"sort": {
"description": "Field name to sort by (not every field is sortable).",
"type": "string"
},
"modifiedFromDate": {
"description": "Only customers modified on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"modifiedToDate": {
"description": "Only customers modified on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_get_customer(organizationId, customerId)
Read one customer by id, including address, e-mail and invoice delivery settings. Conta API: GET /invoice/organizations/{organizationId}/customers/{customerId}.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"customerId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Customer id (from conta_search_customers)."
}
},
"required": [
"organizationId",
"customerId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴conta_create_customer(organizationId, name, customerType, customerAddressLine1, customerAddressPostcode, ...)
Create a customer in an organization. Writes live accounting data. Required: name, customerType (the code Conta expects), and the customer's street, postcode and city. Conta API: POST /invoice/organizations/{organizationId}/customers.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"name": {
"type": "string",
"minLength": 1,
"description": "Customer name."
},
"customerType": {
"type": "string",
"minLength": 1,
"description": "Customer type code, as the Conta API expects it."
},
"customerAddressLine1": {
"type": "string",
"minLength": 1,
"description": "Street address."
},
"customerAddressPostcode": {
"type": "string",
"minLength": 1,
"description": "Postcode."
},
"customerAddressCity": {
"type": "string",
"minLength": 1,
"description": "City."
},
"customerAddressCountry": {
"description": "Country name or code, as Conta accepts it.",
"type": "string"
},
"orgNo": {
"description": "Organization number (orgnr).",
"type": "string"
},
"emailAddress": {
"description": "E-mail address for invoices.",
"type": "string"
},
"phoneNo": {
"description": "Phone number.",
"type": "string"
}
},
"required": [
"organizationId",
"name",
"customerType",
"customerAddressLine1",
"customerAddressPostcode",
"customerAddressCity"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_search_invoices(organizationId, q, page, hits, sort, ...)
Search invoices of an organization with extra information. Filter by date range, customer, type or invoice number. Read only. Conta API: GET /invoice/organizations/{organizationId}/invoices.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"q": {
"description": "Partial-word search across the main fields.",
"type": "string"
},
"page": {
"description": "Page number, starting at 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"hits": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
},
"sort": {
"description": "Field name to sort by (not every field is sortable).",
"type": "string"
},
"fromDate": {
"description": "Invoices dated on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"toDate": {
"description": "Invoices dated on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"type": {
"description": "Invoice type, as Conta names it.",
"type": "string"
},
"customerId": {
"description": "Only invoices of this customer.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"invoiceNo": {
"description": "Invoice number.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"invoiceCurrency": {
"description": "Currency code, e.g. NOK.",
"type": "string"
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_get_invoice(organizationId, invoiceId)
Read one invoice by id, with its lines, totals and payment status. Read only. Conta API: GET /invoice/organizations/{organizationId}/invoices/{invoiceId}.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"invoiceId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Invoice id (from conta_search_invoices)."
}
},
"required": [
"organizationId",
"invoiceId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_get_unpaid_invoices(organizationId)
Return the three latest unpaid invoices with the key figures: total unpaid and overdue sums. Read only. Conta API: GET /invoice/organizations/{organizationId}/invoices/unpaid.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_search_invoice_payments(organizationId, q, page, hits, sort, ...)
Search payments recorded against invoices in an organization, with an optional date range. Read only. Conta API: GET /invoice/organizations/{organizationId}/invoice-payments.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"q": {
"description": "Partial-word search across the main fields.",
"type": "string"
},
"page": {
"description": "Page number, starting at 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"hits": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
},
"sort": {
"description": "Field name to sort by (not every field is sortable).",
"type": "string"
},
"fromDate": {
"description": "Payments on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"toDate": {
"description": "Payments on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_search_invoice_drafts(organizationId, q, page, hits, sort, ...)
List and search invoice drafts (not yet issued) in an organization. Read only. Conta API: GET /invoice/organizations/{organizationId}/invoice-drafts.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"q": {
"description": "Partial-word search across the main fields.",
"type": "string"
},
"page": {
"description": "Page number, starting at 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"hits": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
},
"sort": {
"description": "Field name to sort by (not every field is sortable).",
"type": "string"
},
"fromDate": {
"description": "Drafts on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"toDate": {
"description": "Drafts on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"customerId": {
"description": "Only drafts of this customer.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_search_products(organizationId, q, page, hits, sort, ...)
Search products and services of an organization by free text, or list them. Read only. Conta API: GET /invoice/organizations/{organizationId}/products.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"q": {
"description": "Partial-word search across the main fields.",
"type": "string"
},
"page": {
"description": "Page number, starting at 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"hits": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
},
"sort": {
"description": "Field name to sort by (not every field is sortable).",
"type": "string"
},
"fromDate": {
"description": "Products modified on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"toDate": {
"description": "Products modified on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_list_bank_accounts(organizationId)
List the bank accounts of an organization (IBAN, account number, name, invoicing use). Read only. Conta API: GET /invoice/organizations/{organizationId}/bank-accounts.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_get_open_receivables(organizationId, customerId, customerName, startDate, endDate, ...)
Open accounts receivable for one customer or all customers, as of an optional period. Read only. Conta API: GET /accounting/organizations/{organizationId}/reports/accounts-receivable/open.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"customerId": {
"description": "Only this customer (default: all customers).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"customerName": {
"description": "Only customers whose name matches.",
"type": "string"
},
"startDate": {
"description": "Period start (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"endDate": {
"description": "Period end (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"departmentId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"projectId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number, starting at 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"recordsPerPage": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_get_trial_balance(organizationId, startDate, endDate, startBookkeepingAccountNo, endBookkeepingAccountNo, ...)
Trial balance (saldobalanse) for an organization over a period, optionally limited to an account range. Read only. Conta API: GET /accounting/organizations/{organizationId}/reports/trial-balance.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Period start (yyyy-mm-dd)."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Period end (yyyy-mm-dd)."
},
"startBookkeepingAccountNo": {
"description": "First account number in the range.",
"type": "string"
},
"endBookkeepingAccountNo": {
"description": "Last account number in the range.",
"type": "string"
},
"departmentId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"projectId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"organizationId",
"startDate",
"endDate"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_get_profit_and_loss(organizationId, startDate, endDate, departmentId, projectId)
Profit and loss report (resultatregnskap) for an organization over a period. Read only. Conta API: GET /accounting/organizations/{organizationId}/reports/profit-and-loss-report.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Period start (yyyy-mm-dd)."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Period end (yyyy-mm-dd)."
},
"departmentId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"projectId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"organizationId",
"startDate",
"endDate"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_search_suppliers(organizationId, q, page, hits, sort, ...)
Search suppliers (leverandører) of an organization by free text, or list them. Read only. Conta API: GET /accounting/organizations/{organizationId}/suppliers.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"q": {
"description": "Partial-word search across the main fields.",
"type": "string"
},
"page": {
"description": "Page number, starting at 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"hits": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
},
"sort": {
"description": "Field name to sort by (not every field is sortable).",
"type": "string"
},
"fromDate": {
"description": "Suppliers modified on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"toDate": {
"description": "Suppliers modified on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢conta_list_transactions(organizationId, startDate, endDate, departmentId, projectId, ...)
List ledger transactions and their lines (bilag) for an organization over a period. Read only. Conta API: GET /accounting/organizations/{organizationId}/transactions2.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Organization id (from conta_list_organizations)."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Period start (yyyy-mm-dd)."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Period end (yyyy-mm-dd)."
},
"departmentId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"projectId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number, starting at 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"recordsPerPage": {
"description": "Items per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
}
},
"required": [
"organizationId",
"startDate",
"endDate"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia