Conta MCP by usefulapi
Read customers, invoices, payments, ledgers and reports; create customers in Conta.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"conta": {
"url": "https://conta.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://conta.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(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.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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"
}コミュニティ
エビデンス