Cuéntica MCP by usefulapi

Read invoices, incomes and expenses; create customers and providers in Cuéntica.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
82%
이름 품질
79%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (1)

  • LOWTool 'cuentica_get_invoice_public_link' name length outside 3-30 rangecuentica_get_invoice_public_link에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~3,740토큰 (도구 정의)
~1.9 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.92%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "cuentica": {
      "url": "https://cuentica.usefulapi.io/mcp"
    }
  }
}

원격 엔드포인트

https://cuentica.usefulapi.io/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (18)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢cuentica_get_company

Get the data of the company this token belongs to. Run this first to confirm the connection. Cuéntica API: GET /company.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_list_series

List the invoice series of the company. Use the name in invoice filters. Cuéntica API: GET /company/serie.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_list_tags

List the tags of the company. Cuéntica API: GET /tag.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_list_accounts

List the company accounts: bank accounts, debit or credit cards and partner accounts. Cuéntica API: GET /account.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_get_account(id)

Get one company account by id. Cuéntica API: GET /account/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric id from the matching list tool."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_list_customers(q, page_size, page)

List customers, paged. Search text matches the business name, address, tax id, phone or email. Cuéntica API: GET /customer.

입력 스키마

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Text to search in name, address, tax id, phone and email.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-300. Default set by Cuéntica.",
      "type": "integer",
      "minimum": 1,
      "maximum": 300
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_get_customer(id)

Get one customer by id. Cuéntica API: GET /customer/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric id from the matching list tool."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_list_providers(q, page_size, page)

List providers (suppliers), paged. Search text matches the business name, address, tax id, phone or email. Cuéntica API: GET /provider.

입력 스키마

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Text to search in name, address, tax id, phone and email.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-300. Default set by Cuéntica.",
      "type": "integer",
      "minimum": 1,
      "maximum": 300
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_get_provider(id)

Get one provider by id. Cuéntica API: GET /provider/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric id from the matching list tool."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴cuentica_create_customer(business_type, address, town, postal_code, tradename, ...)

Create a customer. Required: business_type, address, town, postal_code; business_name for companies; name and surname_1 for individuals. Cuéntica API: POST /customer.

입력 스키마

{
  "type": "object",
  "properties": {
    "business_type": {
      "type": "string",
      "enum": [
        "individual",
        "company",
        "others"
      ],
      "description": "individual = sole trader, company = legal company, others = community of goods or institution."
    },
    "address": {
      "type": "string",
      "description": "Street, number, floor."
    },
    "town": {
      "type": "string",
      "description": "Town or city."
    },
    "postal_code": {
      "type": "string",
      "description": "Postal code."
    },
    "tradename": {
      "description": "Trade name. Required for companies. Cuéntica creates one for individuals when omitted.",
      "type": "string"
    },
    "business_name": {
      "description": "Legal name. Required when business_type is company or others.",
      "type": "string"
    },
    "name": {
      "description": "First name. Required when business_type is individual.",
      "type": "string"
    },
    "surname_1": {
      "description": "First surname. Required when business_type is individual.",
      "type": "string"
    },
    "surname_2": {
      "description": "Second surname.",
      "type": "string"
    },
    "tax_id": {
      "description": "Tax id (NIF, CIF or foreign id).",
      "type": "string"
    },
    "tax_id_type": {
      "description": "Type of tax id. Cuéntica uses the country default when omitted.",
      "type": "string",
      "enum": [
        "nif",
        "vat_id",
        "passport",
        "country_document",
        "residence_certificate",
        "other",
        "not_registered",
        "unidentified"
      ]
    },
    "country_code": {
      "description": "ISO country code.",
      "type": "string"
    },
    "region": {
      "description": "Province (Spain only).",
      "type": "string"
    },
    "email": {
      "description": "Email address.",
      "type": "string"
    },
    "phone": {
      "description": "Phone number.",
      "type": "string"
    },
    "fax": {
      "description": "Fax number.",
      "type": "string"
    },
    "web": {
      "description": "Website.",
      "type": "string"
    },
    "contact_person": {
      "description": "Contact person name.",
      "type": "string"
    },
    "personal_comment": {
      "description": "Internal comment.",
      "type": "string"
    },
    "default_payment_method": {
      "description": "Default payment method for this party.",
      "type": "string",
      "enum": [
        "cash",
        "receipt",
        "wire_transfer",
        "card",
        "promissory_note",
        "other"
      ]
    },
    "default_invoice_language": {
      "description": "Invoice language code, or 'default'.",
      "type": "string"
    },
    "has_surcharge": {
      "description": "Apply the equivalence surcharge to this customer.",
      "type": "boolean"
    }
  },
  "required": [
    "business_type",
    "address",
    "town",
    "postal_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴cuentica_create_provider(business_type, address, town, postal_code, tradename, ...)

Create a provider (supplier). Required: business_type, address, town, postal_code; business_name for companies; name and surname_1 for individuals. Cuéntica API: POST /provider.

입력 스키마

{
  "type": "object",
  "properties": {
    "business_type": {
      "type": "string",
      "enum": [
        "individual",
        "company",
        "others"
      ],
      "description": "individual = sole trader, company = legal company, others = community of goods or institution."
    },
    "address": {
      "type": "string",
      "description": "Street, number, floor."
    },
    "town": {
      "type": "string",
      "description": "Town or city."
    },
    "postal_code": {
      "type": "string",
      "description": "Postal code."
    },
    "tradename": {
      "description": "Trade name. Required for companies. Cuéntica creates one for individuals when omitted.",
      "type": "string"
    },
    "business_name": {
      "description": "Legal name. Required when business_type is company or others.",
      "type": "string"
    },
    "name": {
      "description": "First name. Required when business_type is individual.",
      "type": "string"
    },
    "surname_1": {
      "description": "First surname. Required when business_type is individual.",
      "type": "string"
    },
    "surname_2": {
      "description": "Second surname.",
      "type": "string"
    },
    "tax_id": {
      "description": "Tax id (NIF, CIF or foreign id).",
      "type": "string"
    },
    "tax_id_type": {
      "description": "Type of tax id. Cuéntica uses the country default when omitted.",
      "type": "string",
      "enum": [
        "nif",
        "vat_id",
        "passport",
        "country_document",
        "residence_certificate",
        "other",
        "not_registered",
        "unidentified"
      ]
    },
    "country_code": {
      "description": "ISO country code.",
      "type": "string"
    },
    "region": {
      "description": "Province (Spain only).",
      "type": "string"
    },
    "email": {
      "description": "Email address.",
      "type": "string"
    },
    "phone": {
      "description": "Phone number.",
      "type": "string"
    },
    "fax": {
      "description": "Fax number.",
      "type": "string"
    },
    "web": {
      "description": "Website.",
      "type": "string"
    },
    "contact_person": {
      "description": "Contact person name.",
      "type": "string"
    },
    "personal_comment": {
      "description": "Internal comment.",
      "type": "string"
    },
    "default_payment_method": {
      "description": "Default payment method for this party.",
      "type": "string",
      "enum": [
        "cash",
        "receipt",
        "wire_transfer",
        "card",
        "promissory_note",
        "other"
      ]
    },
    "default_retention": {
      "description": "Default withholding percentage for this provider.",
      "type": "number"
    },
    "default_expense_type": {
      "description": "Default expense type code for this provider.",
      "type": "string"
    }
  },
  "required": [
    "business_type",
    "address",
    "town",
    "postal_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_list_invoices(customer, issued, serie, description, initial_date, ...)

List sales invoices, paged. issued=true lists issued invoices; issued=false lists drafts. Cuéntica API: GET /invoice.

입력 스키마

{
  "type": "object",
  "properties": {
    "customer": {
      "description": "Only invoices of this customer id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "issued": {
      "description": "true = issued invoices, false = drafts.",
      "type": "boolean"
    },
    "serie": {
      "description": "Invoice series name (from cuentica_list_series).",
      "type": "string"
    },
    "description": {
      "description": "Text the description must contain.",
      "type": "string"
    },
    "initial_date": {
      "description": "Invoices dated after this date, yyyy-MM-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "end_date": {
      "description": "Invoices dated before this date, yyyy-MM-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "min_total_limit": {
      "description": "Invoices with a total above this amount.",
      "type": "number"
    },
    "max_total_limit": {
      "description": "Invoices with a total below this amount.",
      "type": "number"
    },
    "sort": {
      "description": "Sort as key:order pairs, e.g. customer:desc. Keys: customer, description, total_base, total_invoice, number, date. Orders: asc, desc.",
      "type": "string",
      "pattern": "^(?:customer|description|total_base|total_invoice|number|date):(?:asc|desc)(?:,(?:customer|description|total_base|total_invoice|number|date):(?:asc|desc))*$"
    },
    "tags": {
      "description": "Comma-separated tags. A result must contain all of them.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-300. Default set by Cuéntica.",
      "type": "integer",
      "minimum": 1,
      "maximum": 300
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_get_invoice(id)

Get one invoice by id, with its lines, charges and Verifactu or TicketBAI register info. Cuéntica API: GET /invoice/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric id from the matching list tool."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_get_invoice_public_link(id)

Get the public preview link of one invoice. The preview has the payment button for the company's Stripe account. Cuéntica API: GET /invoice/{id}/public.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric id from the matching list tool."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_list_incomes(customer, initial_date, end_date, min_total_limit, max_total_limit, ...)

List incomes (money received records), paged. Cuéntica API: GET /income.

입력 스키마

{
  "type": "object",
  "properties": {
    "customer": {
      "description": "Only incomes of this customer id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "initial_date": {
      "description": "Incomes dated after this date, yyyy-MM-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "end_date": {
      "description": "Incomes dated before this date, yyyy-MM-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "min_total_limit": {
      "description": "Incomes with a total above this amount.",
      "type": "number"
    },
    "max_total_limit": {
      "description": "Incomes with a total below this amount.",
      "type": "number"
    },
    "sort": {
      "description": "Sort as key:order pairs, e.g. customer:desc. Keys: customer, document_number, total_base, total_income, date. Orders: asc, desc.",
      "type": "string",
      "pattern": "^(?:customer|document_number|total_base|total_income|date):(?:asc|desc)(?:,(?:customer|document_number|total_base|total_income|date):(?:asc|desc))*$"
    },
    "tags": {
      "description": "Comma-separated tags. A result must contain all of them.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-300. Default set by Cuéntica.",
      "type": "integer",
      "minimum": 1,
      "maximum": 300
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_get_income(id)

Get one income by id. Cuéntica API: GET /income/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric id from the matching list tool."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_list_expenses(provider, initial_date, end_date, min_total_limit, max_total_limit, ...)

List expenses (costs), paged. draft=true also shows drafts. Cuéntica API: GET /expense.

입력 스키마

{
  "type": "object",
  "properties": {
    "provider": {
      "description": "Only expenses of this provider id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "initial_date": {
      "description": "Expenses dated after this date, yyyy-MM-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "end_date": {
      "description": "Expenses dated before this date, yyyy-MM-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "min_total_limit": {
      "description": "Expenses with a total above this amount.",
      "type": "number"
    },
    "max_total_limit": {
      "description": "Expenses with a total below this amount.",
      "type": "number"
    },
    "expense_type": {
      "description": "Expense type code. A prefix works: 625 also matches 6250000.",
      "type": "string"
    },
    "investment_type": {
      "description": "Only expenses with this investment type.",
      "type": "string"
    },
    "draft": {
      "description": "true = include drafts.",
      "type": "boolean"
    },
    "tags": {
      "description": "Comma-separated tags. A result must contain all of them.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-300. Default set by Cuéntica.",
      "type": "integer",
      "minimum": 1,
      "maximum": 300
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cuentica_get_expense(id)

Get one expense by id. Cuéntica API: GET /expense/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric id from the matching list tool."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 18개