Mothership MCP server
Commit Nov 3, 2026Connects AI assistants to Mothership accounts to quote, track, and manage LTL, truckload, and local freight shipments using plain language.
Also known as mothership/agent-plugins, agent-plugins
- Stars
- 8
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.10
- Last commit
- Nov 3, 2026
- License
- MIT
What is Mothership MCP?
Mothership connects AI assistants to Mothership accounts to quote, track, and manage LTL, truckload, and local freight shipments using plain language.
Summary generated from the project's README
About Mothership MCP server
Mothership provides a remote MCP server that connects AI assistants to your Mothership freight account. This connection allows users to manage logistics through natural language by interacting with LTL, truckload, and local freight data. The server operates via Streamable HTTP at a specific remote endpoint and requires an existing Mothership account for access.
Users authenticate using OAuth 2.1, ensuring the assistant only accesses information permitted by the user's account permissions. The server is compatible with various clients including Claude, ChatGPT, VS Code, and Cursor. While the server provides core functionality, specific plugins for Claude, ChatGPT, Codex, and Cursor can be installed to provide specialized instructions that help the assistant perform complex tasks like estimating freight classes or managing claims.
Logistics professionals can use this to perform diverse tasks such as quoting shipments, tracking cargo via PRO or BOL numbers, and managing billing details. The system also supports administrative actions like canceling shipments with fee transparency, managing teammates, and handling freight claims.
What you can do with it
- 1Get freight shipping quotesAsk your assistant to provide pricing and delivery dates for different shipping methods.
- 2Track existing shipmentsRetrieve real-time status updates and delivery windows using various reference numbers.
- 3Estimate freight classesDetermine the correct NMFC item and freight class based on the dimensions and weight of your cargo.
- 4Manage freight claimsInitiate new claims or respond to existing claim decisions through the chat interface.
Written from the project's README. Every use case is checked against a quote from it.
How to install Mothership MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Mothership MCP in Claude Code
$ claude mcp add --transport http agent-plugins https://mcp.mothership.com/Install Mothership MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agent-plugins": {
"url": "https://mcp.mothership.com/"
}
}
}Install Mothership MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agent-plugins": {
"type": "http",
"url": "https://mcp.mothership.com/"
}
}
}Install Mothership MCP in VS Code CLI
$ code --add-mcp '{"name":"agent-plugins","type":"http","url":"https://mcp.mothership.com/"}'Install Mothership MCP in Codex
$ codex mcp add agent-plugins --url https://mcp.mothership.com/Install Mothership MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.agent-plugins] url = "https://mcp.mothership.com/"
Install Mothership MCP in Gemini CLI
$ gemini mcp add -s user --transport http agent-plugins https://mcp.mothership.com/Install Mothership MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agent-plugins": {
"url": "https://mcp.mothership.com/",
"type": "http"
}
}
}Configuration
CLIENT_ID
Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemothership/agent-plugins is public and reachablegithub.com/mothership/agent-plugins ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-03github.com/mothership/agent-plugins ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubMothership MCP server
Mothership is a freight marketplace for LTL, truckload and local freight. Its MCP server connects your AI assistant to your Mothership account, so you can get rates, track and cancel shipments, find freight classes and check your bills by asking in plain language.
The server is at https://mcp.mothership.com and speaks Streamable HTTP. You sign in with your Mothership account over OAuth 2.1, and the assistant sees only what your account can see. The official MCP Registry lists it as com.mothership/mothership.
This repo also holds the Mothership plugin for Claude, ChatGPT, Codex and Cursor, which adds Mothership's skills to the server. See Plugins.
What it can do
With the server connected, your assistant can:
- Quote LTL, truckload and local freight. It shows each carrier's price and delivery date, with a link to book the rate you pick in the Mothership dashboard. Every quote it gets is saved to your account.
- Track a shipment by its Mothership reference, PRO, BOL or pickup number, or your own reference: status, pickup and delivery windows, carrier, cargo, documents and the newest tracking updates.
- Find, list and count your shipments by date, status or carrier.
- Cancel a shipment. It shows the cancellation fee and refund first, and cancels only after you confirm.
- Find the NMFC item for what you ship, read an item's freight classes, and estimate a class from weight and dimensions.
- Check whether Mothership serves an address, and whether it's residential or limited access.
- Show your invoices, rebills, payment methods and billing details.
- Start freight claims, follow them, and accept or rebut a claim decision.
- Keep your address book, invite and manage teammates, and set up webhooks.
- Search Mothership's help articles and your support conversations.
In clients that support MCP Apps, such as Claude and ChatGPT, quotes and shipments can show as cards.
Connect
Any MCP client that supports remote servers with OAuth can connect to https://mcp.mothership.com. The first time it connects, it opens a Mothership sign-in page, and you approve the client's access. You need a Mothership account. If you don't have one, sign up at https://dashboard.mothership.com/signup.
Clients identify themselves with a Client ID Metadata Document, as Claude, ChatGPT and VS Code do. The server doesn't support dynamic client registration. Cursor signs in with a client ID that Mothership set up for it.
Claude
In claude.ai or the Claude desktop app, add Mothership as a custom connector. On Free, Pro and Max plans:
- Go to Customize > Connectors, select + Add, then Add custom connector.
- Enter
Mothershipas the name andhttps://mcp.mothership.comas the URL, and select Continue. - Keep the authentication settings Claude detects. Under OAuth client, leave Use Claude's published identity selected, since Mothership doesn't support Register automatically.
- Select Add, then sign in with your Mothership account.
On Team and Enterprise plans, an Owner adds the connector from Organization settings > Connectors with Add > Custom > Web. Each member then connects it from Customize > Connectors and signs in with their own Mothership account. See Anthropic's guide to custom connectors.
ChatGPT
- Go to Plugins, select +, then Add custom MCP server.
- Enter a name and description. Under Connection, choose Public endpoint and enter
https://mcp.mothership.com. - Choose OAuth for authentication, accept the risk warning, and select Create as a plugin.
- Sign in with your Mothership account.
Your workspace's policies decide who can add a custom MCP server. ChatGPT keeps the tool list it found when you added the server, so when Mothership adds tools, open the server in Plugins and select Refresh. See OpenAI's guide.
VS Code
Open the Command Palette, run MCP: Add Server, choose HTTP (HTTP or Server-Sent Events), enter https://mcp.mothership.com, and give the server the ID mothership. For a personal setup, choose Global, then Copilot Global. VS Code asks you to sign in with your Mothership account the first time the server starts. See VS Code's MCP guide.
Cursor
Add Mothership to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project:
{
"mcpServers": {
"Mothership": {
"url": "https://mcp.mothership.com",
"auth": { "CLIENT_ID": "cursor" }
}
}
}
CLIENT_ID names the OAuth client Mothership set up for Cursor, because the server has no dynamic client registration. Sign in with your Mothership account when Cursor asks. See Cursor's MCP guide.
Other clients
Other clients can connect with the same URL if they support OAuth with a Client ID Metadata Document. A client that only supports dynamic client registration can't sign in.
Plugins
The mothership plugin connects to the same server and adds Mothership's skills. Skills are instructions that teach the assistant how to get started, quote, track and cancel shipments, explain rebills, check locations and find freight classes. The assistant loads them like its own skills. Without the plugin, the server serves the same skills through its skill-get tool.
Claude Code:
claude plugin marketplace add mothership/agent-plugins
claude plugin install mothership@mothership
Claude on the web and desktop: go to Customize > Plugins, select Add > Add marketplace, and enter mothership/agent-plugins. Add the Mothership plugin, then add and connect Mothership from its Connectors tab. On Team and Enterprise plans, an Owner may need to allow the marketplace or add the connector first.
Codex:
codex plugin marketplace add mothership/agent-plugins
codex plugin add mothership@mothership
ChatGPT workspace admins: go to Admin > Plugins, select Add > Import marketplace, enter https://github.com/mothership/agent-plugins as the Source, and leave Path empty. ChatGPT syncs the marketplace daily. It marks imported plugins that connect to an MCP server as Desktop only, so the plugin works in the ChatGPT desktop app. On chatgpt.com, add the server as a custom MCP server instead.
Cursor team admins, on Teams and Enterprise plans: in the Cursor dashboard, open Plugins & MCPs, select Add Marketplace under Team Marketplaces, choose Import from Repo, and enter https://github.com/mothership/agent-plugins. Members then install the plugin from Customize in Cursor.
After you install the plugin, sign in with your Mothership account when the assistant asks to connect Mothership.
What's in this repo
Each host reads its own marketplace file, and all three list the same plugin folder:
| Marketplace file | Read by |
|---|---|
.claude-plugin/marketplace.json |
Claude |
.agents/plugins/marketplace.json |
ChatGPT and Codex |
.cursor-plugin/marketplace.json |
Cursor |
The plugin folder carries the portable Agent Plugins manifest that ChatGPT and Codex read, the .claude-plugin/plugin.json manifest that Claude reads, and the .cursor-plugin/plugin.json manifest that Cursor reads. ChatGPT, Codex and Claude share one mcp.json, and the Cursor manifest names the same server. server.json is the server's MCP Registry entry.
Support
Visit https://help.mothership.com for help with your account or a shipment.
License
The files in this repository are under the MIT License. The Mothership name and logo are trademarks of Mothership Technologies, Inc., and the license doesn't cover them. Using them needs Mothership's prior written permission. See TRADEMARKS.md. The Mothership terms of service at https://help.mothership.com/terms-of-service-general-terms govern your use of the Mothership service and its MCP server.
Mothership MCP questions
How do I add Mothership MCP to Claude Code?
Run claude mcp add --transport http agent-plugins https://mcp.mothership.com/ in your terminal. Add --scope user to make it available in every project.
How do I add Mothership MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can I do with the Mothership MCP server?
You can quote freight, track shipments by various reference numbers, cancel shipments, find freight classes, check billing details, and manage freight claims.
How do I authenticate with the Mothership server?
The server uses OAuth 2.1 for authentication. When you connect for the first time, it opens a Mothership sign-in page for you to approve access.
Do I need a Mothership account to use this?
Yes, you must have a Mothership account to connect the server.