Integrations

Claude & ChatGPT (MCP)

Connect freightcode® to an AI assistant to check declaration status, look up HS codes and estimate duty from a chat. The connector uses the Model Context Protocol (MCP) and signs you in with your freightcode® account.

Before you start

A freightcode® account that belongs to an organisation. The connector only works within an organisation.
A Claude plan that allows connectors, or ChatGPT with connectors enabled.

Connect in Claude

Open Settings → Connectors and add freightcode®, or add a custom connector with the URL https://mcp.freightcode.co.uk/mcp.
Click Connect and sign in with your freightcode® account.
Review the permissions and click Allow.

Connect in ChatGPT

In Settings → Connectors, add a connector with the URL https://mcp.freightcode.co.uk/mcp.
Sign in with your freightcode® account and click Allow.

What the assistant can do

List declarations

Permission: Read declarations

Lists your organisation's declarations: reference, LRN, MRN, type, status, description and dates.

Get declaration

Permission: Read declarations

Shows one declaration and its HMRC notifications (type, timing, error codes, payment amount and deadline). An accepted submission is not clearance.

Suggest HS codes

Permission: Tariff tools

Suggests 10-digit UK commodity codes for a goods description. Suggestions are AI-generated; confirm the code before you use it.

Duty and preference estimate

Permission: Tariff tools

Calculates duty and any tariff preference for a commodity code, country of origin and customs value, using freightcode®'s tariff engine.

The assistant cannot create, submit, amend or cancel declarations. Those actions stay in freightcode®.

Organisations

If you belong to one organisation, the assistant uses it automatically. If you belong to several, the assistant asks which organisation to use.

Example prompts

"List my latest freightcode declarations."
"What's the HMRC status of declaration FC-…?"
"Suggest an HS code for cotton t-shirts."
"Estimate duty on 6109100010 from China, customs value £1,000."

Privacy and disconnecting

Only the fields listed above are shared with the assistant; account numbers, addresses and raw HMRC messages are never sent. See section 5 of our Privacy Policy. To stop access, disconnect freightcode® in your assistant's connector settings.

Support

Email info@freightcode.co.uk.