Cuéntica MCP by usefulapi
Read invoices, incomes and expenses; create customers and providers in Cuéntica.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWcuentica_get_invoice_public_link에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}커뮤니티
증거