Greece Invoices (AADE myDATA national API)

Official2 toolsLive

by junter1989k-ai · JavaScript

Greece myDATA invoices for AI agents: build AADE XML, transmit to myDATA, query by MARK.

Topics

ai-agentclaudee-invoicegreeceinvoicemcpmcp-servermydatavatwishpool

Captured live from the server via tools/list.

create_invoice

Issue a Greek electronic invoice (τιμολόγιο) into the national AADE myDATA platform. Builds an AadeBookInvoiceType <InvoicesDoc> XML and transmits it to /SendInvoices under your own AADE credentials, returning the official MARK (Μοναδικός Αριθμός Καταχώρησης / unique registration number), invoice UID and QR url. Bring your own credentials as headers: x-aade-user-id (your myDATA user id) and x-aade-subscription-key (your Ocp-Apim subscription key) — both issued by the AADE myDATA portal. Header x-aade-mode: prod switches to the live rail (default = dev / test rail, no fiscal effect). Amounts are in EUR, VAT-exclusive per line. Greek VAT rates map to AADE vatCategory codes automatically: 24 (mainland standard), 13 and 6 (reduced), 17 / 9 / 4 (island reduced), 0 (VAT-exempt, category 7). invoiceType defaults to 1.1 (sales invoice); use 2.1 for a services invoice or 5.1 for a credit note.

Parameters11

issuer_vat	string	optional	Your (issuer/seller) Greek VAT number / ΑΦΜ, 9 digits (EL/GR prefix optional). Recommended; must match the credentials used.
issuer_branch	number	optional	Issuer branch / εγκατάσταση number (BranchID). Default 0 (head office).
counterpart_vat	string	required	Buyer (counterpart) Greek VAT number / ΑΦΜ, 9 digits (EL/GR prefix optional). Always required — v1 covers B2B invoices (invoiceType 1.1/2.1/5.1); retail receipts without a counterpart are not supported yet.
counterpart_country	string	optional	Buyer country ISO code. Default GR.
counterpart_branch	number	optional	Buyer branch number. Default 0.
series	string	optional	Invoice series (σειρά). Default "A".
aa	string	optional	Invoice running number (Α/Α) within the series. Auto-generated if omitted.
issue_date	string	optional	Issue date (ημερομηνία έκδοσης), YYYY-MM-DD. Default: today (UTC).
invoice_type	string	optional	AADE invoiceType code. Default 1.1 (sales invoice). Common: 1.1 sales, 2.1 services, 5.1 credit note.
currency	string	optional	Currency code. Default EUR.
lines	array	required	Invoice lines. Each: net_value (line net total, VAT-exclusive EUR), vat_rate (24\|13\|9\|6\|4\|17\|0). Optional: description, vat_exemption_category (1-31, required by AADE when vat_rate is 0), income_classification_type + income_classification_category (E3/VAT classification if your accounting requires it).

Raw schema

{
  "type": "object",
  "properties": {
    "issuer_vat": {
      "type": "string",
      "description": "Your (issuer/seller) Greek VAT number / ΑΦΜ, 9 digits (EL/GR prefix optional). Recommended; must match the credentials used."
    },
    "issuer_branch": {
      "type": "number",
      "description": "Issuer branch / εγκατάσταση number (BranchID). Default 0 (head office)."
    },
    "counterpart_vat": {
      "type": "string",
      "description": "Buyer (counterpart) Greek VAT number / ΑΦΜ, 9 digits (EL/GR prefix optional). Always required — v1 covers B2B invoices (invoiceType 1.1/2.1/5.1); retail receipts without a counterpart are not supported yet."
    },
    "counterpart_country": {
      "type": "string",
      "description": "Buyer country ISO code. Default GR."
    },
    "counterpart_branch": {
      "type": "number",
      "description": "Buyer branch number. Default 0."
    },
    "series": {
      "type": "string",
      "description": "Invoice series (σειρά). Default \"A\"."
    },
    "aa": {
      "type": "string",
      "description": "Invoice running number (Α/Α) within the series. Auto-generated if omitted."
    },
    "issue_date": {
      "type": "string",
      "description": "Issue date (ημερομηνία έκδοσης), YYYY-MM-DD. Default: today (UTC)."
    },
    "invoice_type": {
      "type": "string",
      "description": "AADE invoiceType code. Default 1.1 (sales invoice). Common: 1.1 sales, 2.1 services, 5.1 credit note."
    },
    "currency": {
      "type": "string",
      "description": "Currency code. Default EUR."
    },
    "lines": {
      "type": "array",
      "minItems": 1,
      "description": "Invoice lines. Each: net_value (line net total, VAT-exclusive EUR), vat_rate (24|13|9|6|4|17|0). Optional: description, vat_exemption_category (1-31, required by AADE when vat_rate is 0), income_classification_type + income_classification_category (E3/VAT classification if your accounting requires it).",
      "items": {
        "type": "object",
        "properties": {
          "net_value": {
            "type": "number",
            "description": "Line net value in EUR, VAT-exclusive (netValue)."
          },
          "vat_rate": {
            "type": "number",
            "description": "VAT rate percent: 24, 13, 9, 6, 4, 17, or 0 (exempt). Mapped to AADE vatCategory automatically."
          },
          "description": {
            "type": "string",
            "description": "Optional line item description (not a myDATA field; echoed in the response only)."
          },
          "vat_exemption_category": {
            "type": "number",
            "description": "AADE vatExemptionCategory code 1-31. Required when vat_rate is 0; defaults to 1 if omitted."
          },
          "income_classification_type": {
            "type": "string",
            "description": "Optional AADE income classificationType, e.g. E3_561_001."
          },
          "income_classification_category": {
            "type": "string",
            "description": "Optional AADE income classificationCategory, e.g. category1_1."
          }
        },
        "required": [
          "net_value",
          "vat_rate"
        ]
      }
    }
  },
  "required": [
    "counterpart_vat",
    "lines"
  ]
}

query_invoice

Look up one of your own transmitted myDATA documents by its MARK. Calls /RequestTransmittedDocs, which returns your transmitted docs with a MARK greater than the value you pass — so this tool requests from MARK-1 and reports whether the exact MARK you asked for was found (found=true means AADE has it registered). Pass mark=0 to list your transmitted documents from the beginning. Safe to call anytime (read-only).

Parameters1

mark

string

required

Result status values: REGISTERED (found, was transmitted by you), NOT_FOUND (no document with that MARK), LISTED (returned in a range listing). The MARK (unique registration number) returned by create_invoice. Pass 0 to list transmitted docs from the start.

Raw schema

{
  "type": "object",
  "properties": {
    "mark": {
      "type": "string",
      "description": "Result status values: REGISTERED (found, was transmitted by you), NOT_FOUND (no document with that MARK), LISTED (returned in a range listing). The MARK (unique registration number) returned by create_invoice. Pass 0 to list transmitted docs from the start."
    }
  },
  "required": [
    "mark"
  ]
}

README.md5 KBView on GitHub

Greece Invoice MCP 🇬🇷 — How can my AI agent issue a myDATA τιμολόγιο (timologio) in Greece?

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "greece-invoice": {
      "type": "http",
      "url": "https://inv-gr.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/greece-invoice-mcp && cd greece-invoice-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Remote MCP server that lets any AI agent issue Greece myDATA electronic invoices (τιμολόγιο / timologio) into the national AADE (ΑΑΔΕ) platform. It builds an AadeBookInvoiceType <InvoicesDoc> XML and transmits it under the merchant's own AADE credentials, returning the official MARK (unique registration number). Stateless, bring-your-own credentials, never stores anything.

Live endpoint: https://inv-gr.wishpool.app/mcp · Registry: app.wishpool/greece-invoice-mcp

Quick start

json

{
  "mcpServers": {
    "greece-invoice": {
      "type": "http",
      "url": "https://inv-gr.wishpool.app/mcp",
      "headers": {
        "x-aade-user-id": "<your myDATA user id>",
        "x-aade-subscription-key": "<your Ocp-Apim subscription key>"
      }
    }
  }
}

You register your ERP once on the AADE myDATA portal and receive a user id + subscription key (the developer/test rail issues them instantly). Requests default to the AADE test rail (no fiscal effect); add x-aade-mode: prod for the live rail. Your credentials never leave your side beyond the per-request header.

Tools

Tool	What it does
`create_invoice`	Build an AadeBookInvoiceType invoice from `counterpart_vat` + `lines` (`net_value`, `vat_rate` 24/13/9/6/4/17/0) and transmit to AADE myDATA `/SendInvoices`. Returns the official `MARK`, invoice `uid`, `qr_url` + computed VAT totals.
`query_invoice`	Look up one of your own transmitted docs by `mark` via `/RequestTransmittedDocs`; `found:true` means AADE has it registered. Pass `mark=0` to list from the start.

Amounts are in EUR, VAT-exclusive per line. Greek VAT rates map to AADE vatCategory automatically: 24 (cat 1, mainland standard), 13 (2), 6 (3), 17 (4), 9 (5), 4 (6), 0 (7, exempt — needs a vat_exemption_category 1-31). invoice_type defaults to 1.1 (sales); use 2.1 for services, 5.1 for a credit note.

No cancel at the API level — corrections are issued as a credit note (invoice_type 5.1). Income classification (E3) is optional per line (income_classification_type / income_classification_category) — supply it if your accounting requires it.

Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them.

Endpoints wrapped (AADE myDATA REST, ERP channel)

Base: DEV https://mydataapidev.aade.gr/ · PROD https://mydatapi.aade.gr/myDATA/
Headers forwarded: aade-user-id, ocp-apim-subscription-key, Content-Type: text/xml
Send: POST /SendInvoices (raw <InvoicesDoc> XML body) → <ResponseDoc> with statusCode + invoiceUid / invoiceMark / qrUrl
Query: GET /RequestTransmittedDocs?mark={n} → your transmitted docs with MARK greater than n

Develop

bash

node test/serve.js   # local server on :3237
node test/e2e.js     # protocol + validation + VAT math + AadeBookInvoiceType structure + fake-header live probes

Safety

Pure stateless translation layer over the national AADE myDATA API. The user id + subscription key travel per-request in headers, nothing is stored. Privacy policy.

Sister servers

National e-invoicing, one family: Romania e-Factura (inv-ro) · Mexico CFDI (inv-mx) · Brazil NF-e (inv-br) · Chile DTE (inv-cl) · Peru CPE (inv-pe) · India GST (inv-in). Local payments in 81 countries: mcp.wishpool.app.

MIT licensed.

Install

Tools (2)

create_invoicequery_invoice

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://inv-gr.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "greece-invoice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://inv-gr.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.