Skip to content

Agent plugins

A plugin installs the connector and the workflow guidance together, so your assistant does not only have the tools, it knows how Freight Right expects them to be used. Cursor and Grok Bot install from their listings. ChatGPT connects from its plugin page. Claude Code, Codex, GitHub Copilot CLI, the Grok CLI, Gemini CLI, Antigravity and Muse Code use the commands on this page.

Testing an integration against staging?

The plugin ships the production URL, https://mcp.freightright.com/mcp. Developers who want the staging connector beside it add that one by hand. The exact command or file for each client is on Developer tools, under a different server name so the two never collide. The skills work with either.

The connector on its own gives an assistant thirty-six tools. The plugin adds the judgment that goes with them: which of two organization lists a shipment is billed through, that repeating a price check costs nothing, that an estimate that has passed is not a delay, that an administrator names the organization to bill, and that no tool here can book freight on your behalf.

Cursor

Freight Right is on the Cursor Marketplace. Click Add to Cursor on that page, or in Cursor open Customize, search Freight Right and click Install. The walkthrough is on the Cursor page.

To add the plugin from git instead:

cursor-agent plugin marketplace add https://github.com/freight-right/agent-plugins

Cursor takes a full git URL rather than owner/repo, and indexes the default branch unless you pass --git-ref <branch|tag>. A marketplace is added per account; enable the plugin from the plugin list in Cursor.

Grok Bot

Freight Right is a Grok Bot plugin (plugin id 74434629). Open the listing and add it, then sign in. Grok Bot is a separate product from the Grok chat app. The walkthrough is on the Grok Bot page.

Claude Code

  1. Add the marketplace and install the plugin
    claude plugin marketplace add freight-right/agent-plugins
    claude plugin install freightright@freightright
    
    Inside a session, /plugin marketplace add freight-right/agent-plugins does the same thing.
  2. Sign in Run /mcp, choose freightright, and sign in with your Shipment Manager account. There is no key or secret to paste. The plugin contains no credentials.
  3. Give it room to answer Set your tool timeout to at least 60 seconds. A price check asks carriers live, and a slow lane genuinely takes that long.

Already added the connector by hand?

Remove your existing server first: claude mcp remove freight-right. Two copies of the same connector means two sign-ins and two sets of tools, and your assistant will not know which to use.

Codex

codex plugin marketplace add freight-right/agent-plugins
codex plugin add freightright@freightright

GitHub Copilot CLI

copilot plugin marketplace add freight-right/agent-plugins
copilot plugin install freightright@freightright

Grok CLI

These commands are for the Grok CLI, not Grok Bot. Grok Bot users should use the listing above.

grok plugin marketplace add freight-right/agent-plugins
grok plugin install freightright@agent-plugins --trust

The Grok CLI reads the portable manifest, so it needs nothing specific to it. --trust is the CLI's own confirmation that a plugin may run skills and MCP servers on your machine.

To add only the connector, without the plugin:

grok mcp add freight-right https://mcp.freightright.com/mcp

Muse Code

Muse Code's plugin commands are a developer preview: in 1.3.0 every muse plugins call, install, update or remove, runs only with MUSE_EXPERIMENTAL_PLUGINS=1. A session loads the installed plugin without the flag.

MUSE_EXPERIMENTAL_PLUGINS=1 muse plugins marketplace add freightright freight-right/agent-plugins
MUSE_EXPERIMENTAL_PLUGINS=1 muse plugins install freightright@freightright

The install prints a dozen warnings: multiple-manifests, agent-overlay-inactive, and one unsupported-capability for the MCP server. They are expected. Muse Code reads the portable manifest, notes the other clients' files beside it, and installs the five skills. What it does not do yet is start a plugin's HTTP MCP server, so the connector goes into ~/.config/muse/settings.json and you sign in from the command line:

{
  "schema_version": 1,
  "mcpServers": {
    "freightright": {
      "type": "streamable-http",
      "url": "https://mcp.freightright.com/mcp",
      "mode": "optional"
    }
  }
}
muse mcp login freightright

mode: optional keeps Muse Code starting when the connector is unreachable. Keep whatever else the file already holds, and never put required beside mode on the same entry. Muse Code drops the whole mcpServers member when it sees both.

Gemini CLI

gemini extensions install https://github.com/freight-right/agent-plugins

Start gemini, then run /mcp auth freightright and sign in with your Shipment Manager account. There is no key or secret to paste. The extension sets the tool timeout to 60 seconds. This is Gemini CLI, the command-line tool, only. The walkthrough is on the Gemini CLI page.

Already added the connector by hand?

Remove your existing server first: gemini mcp remove freight-right. Two copies of the same connector means two sign-ins and two sets of tools, and your assistant will not know which to use.

Google Antigravity

agy plugin install https://github.com/freight-right/agent-plugins

Start agy, or open the Antigravity App. In the CLI, open /plugin, expand Freight Right under Installed, and choose Sign in. Your browser opens Freight Right. Sign in with your Shipment Manager account. There is no key or secret to paste. The plugin leaves Antigravity's own timeouts in place: 180 seconds for a tool call and 300 seconds to connect. This covers the Antigravity App, the Antigravity CLI, and the Antigravity IDE. The walkthrough is on the Google Antigravity page.

Already added the connector by hand?

Remove the server you added in ~/.gemini/config/mcp_config.json or .agents/mcp_config.json before you use the plugin. Two copies of the same connector means two sign-ins and two sets of tools, and your assistant will not know which to use.

What the skills cover

Skill It knows
Connection and billing What this connection may do: a customer's organizations or, for an administrator, every organization and the one to bill, and whether a price is billed to an organization or a company name
Instant pricing What each mode needs, resolving places to codes, and what a price check costs
Quote requests When only Freight Right's pricing team can answer, how to ask, how to find a quote by organization, text or date and read one by its number, and how a PO discrepancy is reported to the team
Booking handoff Preparing a confirmation link, the expiry windows, which requests this connection may book, and reading what you decided
Shipment tracking Searching by any reference, narrowing to one organization, reading dates and milestones correctly, a container's contents and last free day, a shipment's billing and customs (per currency, never added), its documents (a link lives minutes) and the events feed

Your assistant loads a skill when it is relevant, so none of this takes up room until it is needed.

The connector it installs

Production Live
https://mcp.freightright.com/mcp

Your live Freight Right account: real shipments, real prices, real bookings. This is the URL used throughout these pages, and the one the agent plugins ship.

Staging Live
https://staging-mcp.sm.freightright.com/mcp

For developers testing an integration. Sign in with a staging Shipment Manager account; everything there is test data, and a booking placed there reaches nobody.

The plugin ships the production URL. To try an integration against staging, add the staging URL above by hand as a second server; the plugin's skills work with either.

Source

The plugin is open source under the MIT licence at github.com/freight-right/agent-plugins. The skills are plain Markdown, so you can read exactly what your assistant is told. The repository's README carries the compatibility matrix with the client versions each install was verified on. The repository is published with the production release; until then the link answers only to Freight Right's own GitHub members.