Wrapp MCP by usefulapi
Read invoices, PDFs and myDATA status; save and delete draft invoices in Wrapp.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWwrapp_list_open_catering_order_notes에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"wrapp": {
"url": "https://wrapp.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://wrapp.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (20)
🟢wrapp_get_account
Get the Wrapp account details: the primary user, plan name, whether invoicing and API access are active, and the myDATA state. Good first call. Wrapp API: GET /tenant_details.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_list_branches
List the branches (business locations) of the company, with their ids. Wrapp API: GET /branches.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_list_billing_books
List the billing books (numbered document series) with their ids. Each invoice belongs to one billing book. Wrapp API: GET /billing_books.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_list_vat_exemptions
List the VAT exemption reasons that an invoice line can cite. Wrapp API: GET /vat_exemptions.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_search_vat(vat, country_code)
Look up a company by its VAT number and country, to fill in a customer's name and address. Wrapp API: GET /vat_search.
입력 스키마
{
"type": "object",
"properties": {
"vat": {
"type": "string",
"minLength": 1,
"description": "The company VAT number, without the country prefix."
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Country ISO 2 code, for example EL for Greece."
}
},
"required": [
"vat",
"country_code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_list_invoices(start_date, end_date, status, page)
List issued invoices (or drafts), 50 per page, with their full myDATA-formatted details. Filter by issue date range. Wrapp API: GET /invoices/find_all_invoices.
입력 스키마
{
"type": "object",
"properties": {
"start_date": {
"description": "Only invoices issued on or after this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"description": "Only invoices issued on or before this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"status": {
"description": "Set to draft to list drafts instead of issued invoices.",
"type": "string",
"enum": [
"draft"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_get_invoice(invoice_id)
Get one invoice by id with its status and myDATA mark, so you can see whether it reached AADE. Wrapp API: GET /invoices/{id}.
입력 스키마
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"minLength": 1,
"description": "The id (from the matching list tool)."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_get_invoice_details(invoice_id)
Get the full myDATA-formatted details of one issued invoice: lines, taxes, counterpart and marks. Wrapp API: GET /invoices/{invoice_id}/find_invoice_by_id.
입력 스키마
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"minLength": 1,
"description": "The id (from the matching list tool)."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_get_invoice_pdf(invoice_id, locale)
Get the PDF of an issued invoice. The first call starts generation, and Wrapp sends a webhook when the PDF is ready; later calls return the download link. Only issued invoices have a PDF. Wrapp API: GET /invoices/{invoice_id}/generate_pdf.
입력 스키마
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"minLength": 1,
"description": "The id (from the matching list tool)."
},
"locale": {
"description": "PDF language (default el).",
"type": "string",
"enum": [
"el",
"en"
]
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_count_issued_invoices
Count all issued invoices on the account. Wrapp API: GET /invoices/issued_count.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_list_open_catering_order_notes(page)
List the open catering order notes (restaurant orders not yet invoiced). Wrapp API: GET /invoices/list_open_catering_order_notes.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_list_pos_devices
List the POS devices registered to the account, with their ids. A POS device id is needed to issue an invoice paid on a terminal. Wrapp API: GET /pos_devices.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_list_catering_tables
List the catering tables (restaurant tables) and their status: available, open, closed or alert. Wrapp API: GET /catering_tables.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_get_catering_table(table_id)
Get one catering table by id, with its status and open order notes. Wrapp API: GET /catering_tables/{id}.
입력 스키마
{
"type": "object",
"properties": {
"table_id": {
"type": "string",
"minLength": 1,
"description": "The id (from the matching list tool)."
}
},
"required": [
"table_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_list_digital_transports(category, page)
List digital transports (delivery notes for goods in transit), 10 per page. category: shipping (default), receiving or carrying. Wrapp API: GET /digital_transports.
입력 스키마
{
"type": "object",
"properties": {
"category": {
"description": "Which transports to list (default shipping).",
"type": "string",
"enum": [
"shipping",
"receiving",
"carrying"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_get_digital_transport(transport_id)
Get one digital transport (delivery note) by id, with its status and goods. Wrapp API: GET /digital_transports/{id}.
입력 스키마
{
"type": "object",
"properties": {
"transport_id": {
"type": "string",
"minLength": 1,
"description": "The id (from the matching list tool)."
}
},
"required": [
"transport_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢wrapp_get_digital_clientele(clientele_id)
Get one digital clientele entry (a myDATA service record) by id. Wrapp API: GET /digital_clienteles/{id}.
입력 스키마
{
"type": "object",
"properties": {
"clientele_id": {
"type": "string",
"minLength": 1,
"description": "The id (from the matching list tool)."
}
},
"required": [
"clientele_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴wrapp_create_draft_invoice(invoice)
Save an invoice as a DRAFT. It is NOT sent to myDATA and gets no tax mark. The tool forces draft to true. Send every total yourself: Wrapp computes none. Use a unique external_id, so a retry cannot create a second document. Wrapp API: POST /invoices with draft: true.
입력 스키마
{
"type": "object",
"properties": {
"invoice": {
"type": "object",
"properties": {
"invoice_type_code": {
"type": "string",
"minLength": 1,
"description": "myDATA document type, for example '1.1' (sales invoice) or '11.1' (retail receipt)."
},
"billing_book_id": {
"type": "string",
"minLength": 1,
"description": "The billing book id (from wrapp_list_billing_books)."
},
"invoice_lines": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Lines with name, quantity, unit_price, vat_rate and the line totals."
},
"net_total_amount": {
"description": "Net total of the document.",
"type": "number"
},
"vat_total_amount": {
"description": "VAT total of the document.",
"type": "number"
},
"total_amount": {
"description": "Gross total of the document.",
"type": "number"
},
"payable_total_amount": {
"description": "Amount payable.",
"type": "number"
},
"external_id": {
"type": "string",
"minLength": 1,
"description": "Your own unique reference, required. A second document with the same one is refused, so a retry cannot create a second draft."
},
"counterpart": {
"description": "The customer: name, vat, country and address fields.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"invoice_type_code",
"billing_book_id",
"invoice_lines",
"external_id"
],
"additionalProperties": {}
}
},
"required": [
"invoice"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴wrapp_set_invoice_external_id(invoice_id, external_id)
Set your own permanent reference (external_id) on an invoice that has none yet. It cannot be changed later and must be unique on the account. Wrapp API: PUT /invoices/{invoice_id}/set_external_id.
입력 스키마
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"minLength": 1,
"description": "The id (from the matching list tool)."
},
"external_id": {
"type": "string",
"minLength": 1,
"description": "Your own unique reference."
}
},
"required": [
"invoice_id",
"external_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴wrapp_delete_draft_invoice(invoice_id)
Delete a draft invoice. Only drafts that were never sent to myDATA can be deleted; an issued invoice is refused. Wrapp API: DELETE /invoices/{invoice_id}/delete_draft.
입력 스키마
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"minLength": 1,
"description": "The id (from the matching list tool)."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거