TariffPilot Headless: connect Claude, ChatGPT and other MCP clients
With TariffPilot Headless you work with TariffPilot from an AI assistant instead of the Manager. The setup takes about two minutes:
- Add the TariffPilot Manager MCP server with the URL
https://app-cloud.tariffpilot.com/mcp. You sign in once with your TariffPilot account, no API key needed. - Add the TariffPilot plugin from the marketplace
tariffpilot/tariffpilot-skills, so the assistant drives every proposal to the end. - Start classifying. Describe your goods in plain language.
TariffPilot Headless is available in all plans. One connection reaches all your tenants, and the assistant acts with the roles of your TariffPilot user. Proposals created by the assistant are the same proposals you see in the Manager.
In Claude Team and Enterprise, only owners can add custom connectors. An owner adds the connector once under Organization settings > Connectors, then every member signs in with their own TariffPilot account.
Claude
- Open Settings > Connectors and add a custom connector with the name "TariffPilot Manager" and the URL
https://app-cloud.tariffpilot.com/mcp. Sign in to TariffPilot when asked. - Open Settings > Plugins, click Add > Add marketplace and enter
tariffpilot/tariffpilot-skills. Click Sync. - Switch to Discover and add TariffPilot Headless.
Using Claude Code? Run:
/plugin marketplace add tariffpilot/tariffpilot-skills
/plugin install tariffpilot-headless@tariffpilot-skills
The plugin brings the TariffPilot Manager MCP server along. Run /mcp in Claude Code and sign in to TariffPilot.
ChatGPT (Codex)
- Open Plugins and click Add > Add MCP server. Enter the name "TariffPilot Manager", switch the type to Streamable HTTP and enter the URL
https://app-cloud.tariffpilot.com/mcp. Leave all other fields empty, save and sign in to TariffPilot. - Click Add > Add plugin marketplace, enter
tariffpilot/tariffpilot-skillsas source andmainas Git ref. - Switch to Personal and click + next to tariffpilot-headless.
Other clients
Microsoft Copilot Studio, Gemini, OpenWork, OpenCode and other clients work if they support remote MCP servers with login (OAuth). Add the URL https://app-cloud.tariffpilot.com/mcp and sign in to TariffPilot. If your client supports skills but no plugins, copy the folders from plugins/*/skills/ in github.com/tariffpilot/tariffpilot-skills into its skills directory.
What the assistant can do
- Customs tariff classification: create customs tariff proposals for single goods and read their results and reasoning.
- Export control classification: check goods for dual-use and military goods.
- BTI and ECICS search: search binding tariff information and the ECICS database of chemical substances.
- Mass classification: list your mass classification jobs and read their status.
- AI database: read your confirmed classifications (trainings).
A proposal takes a few minutes, as TariffPilot processes it step by step. The skills of the TariffPilot Headless plugin make the assistant start each step, wait for it and continue until the proposal is finished, and then explain the result. Without the plugin, the assistant may stop after the first step and leave the proposal unfinished.
Example prompts
- "Classify a 1000 W microwave oven with grill function for import into the EU in TariffPilot."
- "Check in TariffPilot whether a thermal imaging camera with 640 x 480 pixels is a dual-use good."
- "Search TariffPilot for BTIs on stainless steel kitchen sinks and compare them with the proposal."
- "Which of my mass classification jobs in TariffPilot are still running?"
- "Summarize the reasoning of my last customs tariff proposal in TariffPilot for our documentation."
Data protection
Everything the assistant reads or creates through TariffPilot, for example product descriptions and proposals, is processed by your AI provider, such as Anthropic or OpenAI, under its terms. Check whether your company allows this for your product data. Security and compliance documents are in the TariffPilot Trust Center.
Troubleshooting
- The login does not open: check the URL. In Codex, the type must be Streamable HTTP.
- The assistant can read but not create proposals: your TariffPilot role in this tenant has no edit rights, see Invite colleagues & assign roles.
- The assistant does not use TariffPilot: check that the connector is enabled and the plugin is installed, and mention TariffPilot in your prompt.
- A proposal stays unfinished: install the TariffPilot Headless plugin, then ask the assistant to continue the proposal.
Looking for a programmatic integration with an access token? See the REST API.