ShipHero AI Toolkit

ShipHero supports two ways to use AI with your ShipHero data: the ShipHero MCP and the Public API Skill.

Use the MCP if you want the simplest setup for asking ShipHero questions from an AI client. Use the Skill if you are an advanced user who wants to answer more complex ShipHero questions or if you are interested in building a ShipHero integration.

Why this exists

Warehouse operations generate constant questions: What’s the current inventory level on SKU ABC-123? Which orders have an address hold? Which shipments were created yesterday? Traditionally, answering those questions meant logging into ShipHero, running reports, or building custom integrations.

The ShipHero AI Toolkit gives AI clients a secure way to query live ShipHero data. The MCP is the fastest path for common operational questions. The Skill gives advanced users and developers more context, API guidance, and workflow support for complex analysis and integration work.

ShipHero MCP

The ShipHero MCP is the easiest way to connect an AI client to ShipHero. It lets supported clients query your ShipHero account without requiring you to manually write GraphQL, manage Public API tokens, or install the full skill package.

ShipHero MCP works anywhere MCP is supported, including:

Use the MCP for questions like:

• What’s the current inventory level for SKU ABC-123?
• Show me orders with an address hold.
• Show shipments created yesterday.
• List purchase orders expected to arrive this week.
• Show returns created today.

The MCP is designed for simple ShipHero queries. It is not intended for building full integrations or generating complex custom application code.

MCP Installation

Our MCP server URL is:

https://mcp.shiphero.com/mcp

Installation steps vary by AI client and subscription type. If you are unsure, see your AI client’s documentation.

Claude

Use Claude Connectors for Claude Chat, Claude CoWork, Claude Web, and Claude Desktop. The installation path depends on your Claude account type:

• Team and Enterprise plans
• Free, Pro, and Max plans
• Local installation and Claude Code CLI

See Claude’s official custom connector documentation.

On Team and Enterprise plans

For Team and Enterprise organizations, installation is a two-step process:

1. An organization admin enables the ShipHero MCP organization-wide.
2. Each user connects ShipHero to their own Claude account.

The admin step makes the ShipHero MCP available to the organization. Owners and Primary Owners usually have the required organization admin access. After that, each user who wants to use the MCP must add it to their own Claude account and authenticate with ShipHero.

Step 1: Admin enables ShipHero MCP organization-wide

An organization admin should:

1. Go to Organization settings > Connectors.

2. Click Add > Custom > Web.

3. Enter the following Connector details:

   • Name: ShipHero
   • Remote MCP Server URL: https://mcp.shiphero.com/mcp

4. Click Add.

This enables the ShipHero MCP for the organization. It does not connect any user’s ShipHero account yet.

Step 2: Each user connects ShipHero to their own Claude account

After the admin enables the connector, each user can go to Customize > Connectors, find ShipHero, and click Connect to authenticate their own ShipHero account. Once connected, they can ask ShipHero questions in Claude Chat Web or Desktop, Claude CoWork Chat or Desktop, and Claude Code.

1. On Claude Desktop, go to Chat, CoWork, or Code, and click Customize.
2. Click Connectors, then click the magnifying glass to search.
3. Type ShipHero, click the ShipHero MCP entry, and click Connect.
4. Sign in to ShipHero. Once you are authenticated, click Accept to connect your AI client with ShipHero.
5. Confirm the connection by clicking the + sign, then Connectors. ShipHero should be available for use.
6. You can now prompt your AI client.

On Free, Pro, and Max plans

For individual Claude accounts:

1. Go to Customize.
2. Click Connectors then + sign and Add custom connector.
3. Enter the ShipHero MCP server URL: https://mcp.shiphero.com/mcp and click Add.
4. Click on Connect.
5. Sign in to ShipHero. Once you are authenticated, click Accept to connect your AI client with ShipHero.
6. You have now added the MCP to your account.
7. You can now prompt your AI client.

Local installation and Claude Code CLI

Use this option for local Claude clients that do not use Claude.ai connectors, and Claude Code CLI.

From the command line execute:

claude mcp add --transport http shiphero https://mcp.shiphero.com/mcp

ChatGPT

Use ChatGPT Apps to connect ChatGPT Web and Desktop to the ShipHero MCP. The installation path depends on your plan and workspace controls:

• Business and Enterprise workspaces
• Pro and Plus accounts

See OpenAI’s official ChatGPT developer mode documentation and MCP apps in ChatGPT documentation.

On Business and Enterprise workspaces

For workspace accounts, installation is a two-step process:

1. An admin or owner creates and publishes the ShipHero app.
2. Each user connects ShipHero to their own ChatGPT account.

The admin step makes the ShipHero app available in the workspace. Business admins and owners manage this from workspace settings. Enterprise admins and owners can also use role-based access controls to decide who can use developer mode and who can access the published app. After the app is available, each user still needs to connect it to their own ChatGPT account and authenticate with ShipHero.

Step 1: Admin creates and publishes the ShipHero app

An admin or owner should:

1. Enable Developer mode from Settings > Apps > Advanced settings > Developer mode.
2. Go to Workspace settings > Apps > Create.
3. Create a new app with the following details:
   • Name: ShipHero
   • Connection: Server URL
   • Server URL: https://mcp.shiphero.com/mcp
   • Authentication: OAuth
   • If ChatGPT asks for client registration, choose User-Defined OAuth Client.
   • OAuth Client ID: 00ks8TNFn5J9SrqePsRSHKmiakONdWjU
   • Token endpoint auth method: none
   • Leave OAuth Client Secret empty.
4. Review the custom MCP server risk notice and confirm that you want to continue.
5. Click Scan Tools. If ChatGPT opens a ShipHero authorization flow, sign in and approve it.
6. Click Create. The app appears as a draft.
7. From Workspace settings > Apps > Drafts, review the draft and click Publish. Configure access and actions as needed.

Step 2: Each user connects ShipHero to their own ChatGPT account

After the admin publishes the app, each user should:

1. Go to Settings > Apps.
2. Find the ShipHero app in the workspace app list.
3. Click Connect.
4. Sign in to ShipHero and approve the authorization flow.
5. You can now prompt ChatGPT with ShipHero questions.

On Pro and Plus accounts

For individual ChatGPT accounts:

1. Go to Settings > Apps.
2. Open Advanced settings and enable Developer mode.
3. Click Create app.
4. Create a new app with the following details:
   • Name: ShipHero
   • Connection: Server URL
   • Server URL: https://mcp.shiphero.com/mcp
   • Authentication: OAuth
   • If ChatGPT asks for client registration, choose User-Defined OAuth Client.
   • OAuth Client ID: 00ks8TNFn5J9SrqePsRSHKmiakONdWjU
   • Token endpoint auth method: none
   • Leave OAuth Client Secret empty.
5. Review the custom MCP server risk notice and confirm that you want to continue.
6. Click Scan Tools. If ChatGPT opens a ShipHero authorization flow, sign in and approve it.
7. Click Create. The app appears in Settings > Apps > Enabled apps with a Dev label.
8. You can now prompt ChatGPT with ShipHero questions.

Codex and others

For Codex and other agents use mcp-remote to set up a local STDIO MCP Server.

mcp-remote OAuth configuration:

• Client ID: 00ks8TNFn5J9SrqePsRSHKmiakONdWjU
• Callback port: 41592

mcp-remote invocation:

npx -y mcp-remote@latest https://mcp.shiphero.com/mcp 41592 --transport http-only --static-oauth-client-info '{"client_id":"00ks8TNFn5J9SrqePsRSHKmiakONdWjU"}'

In Codex you can just execute the following to add it manually:

codex mcp add shiphero -- npx -y mcp-remote@latest https://mcp.shiphero.com/mcp 41592 --transport http-only --static-oauth-client-info '{"client_id":"00ks8TNFn5J9SrqePsRSHKmiakONdWjU"}'

For other coding agents see their documentation.

MCP Usage

After installation, ask your AI client a ShipHero question:

Get my last 50 ShipHero orders.

On first use, your browser will open a ShipHero authorization flow.

Keep prompts specific. Ask for the exact object, date range, SKU, order number, warehouse, or status you need. Specific prompts use fewer API credits and return better answers.

Public API Skill

The Public API Skill is for advanced users working from an agentic coding harness. It provides an agent with more advanced capabilities than those of the MCP option.

Use the Skill when you want an agent to:

• Analyze ShipHero data with custom query logic.
• Build or modify software that integrates with ShipHero.
• Know how to use the ShipHero Public API.

The Skill requires a coding agent. It is not meant for Claude Chat or Claude CoWork type of tools. Use the MCP on those clients.

Skill Installation

Download the current Skill package:

shiphero-public-api-skill-20260604.zip

The fastest installation path is to ask your coding agent to install it:

Download the Public API Skill from https://developer.shiphero.com/shiphero-ai-toolkit and install it

For manual installation, extract the zip into your agent’s skill folder.

unzip shiphero-public-api-skill-20260604.zip -d ~/.agents/skills/

Common skill folders:

Restart your agent if it does not load newly installed skills automatically.

Skill Usage

After installation, you can ask your agent ShipHero questions:

How many orders did I receive today on ShipHero?

For integration work, be explicit about the target language, framework, and workflow:

Use the ShipHero Public API Skill to add a Node.js function that fetches inventory by SKU from the ShipHero GraphQL API.

The Skill includes scripts for OAuth PKCE token setup, token refresh, and token revocation. When your work is done, ask the agent to revoke the token if it no longer needs access.

API Credits

Both the MCP and the Skill query the ShipHero Public API. API calls consume API credits.

AI agents can make several calls while answering one question. Ask for only the fields and date ranges you need, and monitor credit usage during testing.