Wrapp MCP by usefulapi
Read invoices, PDFs and myDATA status; save and delete draft invoices in Wrapp.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin wrapp_list_open_catering_order_notes
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"wrapp": {
"url": "https://wrapp.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://wrapp.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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"
}Community
Nachweis