Wrapp MCP by usefulapi
Read invoices, PDFs and myDATA status; save and delete draft invoices in Wrapp.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen wrapp_list_open_catering_order_notes
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": {
"wrapp": {
"url": "https://wrapp.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://wrapp.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia