Skip to main content

​
What is it?

Polygon One exposes its REST API as an MCP server (Model Context Protocol). Your AI assistant uses it with your Polygon One data — articles, suppliers, orders, plots and their analysis, DDS statements, evidence, PPWR packaging units, components, declarations of conformity and volume reports — and works with it in your chat.
Exactly ten write tools. The assistant can create articles, suppliers and orders, update orders, create DDS drafts, update external DDS metadata, and create or update PPWR components and packaging units and link them. It can never delete, invite suppliers, submit or retract a DDS in TRACES, or make a compliance decision. Every call runs under your own user and permissions; writes are audited at their API endpoint.

​
Server URL

​
Signing in: two ways

  • OAuth (recommended) — The assistant sends you to Polygon One. You log in and approve once; the consent screen prominently shows the verified redirect host alongside the application name, requested access and your account. Unknown hosts cannot be approved. Access can be revoked — contact support.
  • API key — for applications that only support a static key (e.g. Microsoft Copilot Studio). Header Authorization, value Bearer eudr_…. Create the key under Settings > API Keys and grant only the permissions you need. The write tools additionally require articles:write, suppliers:write, orders:write, dds:write, and (PPWR) packaging:write. (see Permissions).

​
Setup

1

Add a connector

Open Settings → Connectors and click Add custom connector.
2

Enter the URL

Paste https://app.polygon-one.com/api/mcp and click Connect.
3

Log in and approve

Log in to Polygon One and click Allow.

​
Available tools

Each tool matches an endpoint of the API reference. The list is pinned to 22 read tools and ten write tools; new API writes are not exposed automatically.

​
Example prompts

  • “Which of my orders have no DDS statement yet, and which supplier is blocking?”
  • “Show the analysis result for plot X and tell me what ‘not measured’ means.”
  • “List the packaging units without a signed declaration of conformity.”
  • “Which supplier articles have evidence expiring this quarter?”
  • “Check this order CSV for conflicting HS codes. Import it only after I correct them, wait for the import job, and prepare a DDS draft for the ready orders.”
“Not measured” does not mean “fine”. This is exactly why Polygon One returns structured status flags instead of free text, so the assistant does not present a missing measurement as a clean result.

​
Limits

  • 120 calls per minute per user and assistant.
  • Write calls accept at most 1,000,000 characters in the JSON body; the API’s own row limits also apply.
  • Results are paginated as in the API.
  • File downloads (plot report, declaration PDF) are not available to assistants yet; use the app or the REST API for those.
  • The assistant’s own context window limits how much it can read at once.

​
Troubleshooting

Your data stays in Polygon One. The assistant provider receives only the data and inputs you let it access. Support answers questions about data processing.