Developers

EuroPlaybook has a public REST API and an MCP server for AI assistants. Both use the same API keys and the same rules, and both call the same services as the web app.

What you can do

• Read your catalogue: products, product groups, packaging (layers, lines, items, materials), evidence, regime profiles and reference codes.
• Create or update products by SKU. This writes directly.
• Send sales in bulk (up to 1000 lines per request), idempotent on your own line id. This writes directly.
• Propose packaging lines and regime profiles. A person confirms them in the app.
• Read legal entities, obligations, reporting periods with their totals, and filing packs.

Basics

Base URL	https://api.europlaybook.com/v1
MCP endpoint	https://mcp.europlaybook.com/mcp (streamable HTTP)
Auth	Authorization: Bearer ep_<prefix8>_<secret32> (details)
Format	JSON, UTF-8. IDs are UUID strings. Dates ISO 8601.
Units	Weights integer milligrams (*_mg), money integer cents (*_cents) + ISO 4217 currency, countries ISO 3166-1 alpha-2
Lists	Cursor pagination, 50 items by default, at most 200 (details)
Limits	120 requests per minute per key (details)

The account comes from the key, never from the URL. One key belongs to one account.

For machines

The documentation is written to be read by AI agents and tools as well as people.

URL	What
/llms.txt	Index of the English documentation for LLMs (llmstxt.org)
/llms-full.txt	All English pages in one text file
/llms-small.txt	A shorter version of the above
/openapi.json	OpenAPI 3.1 document of the public API v1 (stable URL)
/data-model.md	The data model as raw Markdown
https://mcp.europlaybook.com/mcp	The MCP server (needs an API key)

Next steps

1. Read the concepts.
2. Create a key and choose scopes.
3. Make your first call with the quick start.
4. Connect an AI assistant with MCP.
5. Look up every endpoint in the API reference.