Gemini CLI¶
Freight Right is a Gemini CLI extension. Install the extension, start Gemini CLI, and sign in with your Shipment Manager login. There is no key or secret to paste.
Gemini CLI only
This works in Gemini CLI, the command-line tool, only. It does not work in the Gemini app on the web (gemini.google.com) or on mobile.
-
Install Gemini CLI
You need Node.js 20 or newer, and
npm install -g @google/gemini-cligitfor the next step. Other installers are on the Gemini CLI installation page. -
Install the Freight Right extension
Run this in your terminal. It is not a command inside a Gemini CLI session.
The extension installs the connector and the workflow guidance together. Its tool timeout is 60 seconds. A price check asks carriers live and can take that long.
gemini extensions install https://github.com/freight-right/agent-plugins -
Start Gemini CLI
Complete Gemini CLI's own sign-in if it asks. Freight Right is a separate sign-in, in the next step.
gemini -
Sign in to Freight Right
Your browser opens Freight Right. Sign in with your Shipment Manager login, or create a free account on that page, and approve the list you are shown. There is no key or secret to paste. The server name is
/mcp auth freightrightfreightright. - Ask about your freight Ask about a shipment, a price or a quote. Gemini CLI shows when it uses Freight Right.
Update the extension¶
Gemini CLI keeps a copy of the extension. To update it, run this in your terminal, then start Gemini CLI again:
gemini extensions update freightright
If the sign-in expires¶
Run /mcp auth freightright again and sign in with your Shipment Manager account.
Already added the connector by hand?¶
Remove it before you use the extension. Two copies of the same connector means two sign-ins and two sets of tools, and your assistant will not know which to use.
gemini mcp remove freight-right
That is the server name on the developer tools page. Run the command in the directory where you added the server. If you added it with --scope user, run gemini mcp remove --scope user freight-right. If you used a different name, remove that name instead.
Endpoints¶
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.
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.