Wrapp MCP by usefulapi

Read invoices, PDFs and myDATA status; save and delete draft invoices in Wrapp.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
73%
Naming quality
79%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'wrapp_list_open_catering_order_notes' name length outside 3-30 rangein wrapp_list_open_catering_order_notes

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,723Tokens (tool definitions)
~812 BTypical response size
Significant attention impact (2.13% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

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

Remote endpoints

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

What it can do

Tool inventory

Tools (20)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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.

Input 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.

Input 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.

Input 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.

Input 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.

Input 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.

Input 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}.

Input 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.

Input 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.

Input 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.

Input 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.

Input 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.

Input 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.

Input 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}.

Input 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.

Input 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}.

Input 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}.

Input 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.

Input 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.

Input 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.

Input 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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded20 tools