MCP server · AI assistants
Tranvoro speaks the Model Context Protocol (MCP), the open standard AI assistants use to work with business software. Connect Claude, ChatGPT, Claude Code or Cursor once, approve what they may do, and ask about your shipments, quotes, customers and margins in plain English. The assistant acts as you, with your role, and every change is audited.
30-day free trial · No credit card required
What you can ask
These are illustrative prompts, with the Tranvoro tools an assistant would typically use to answer them. The assistant decides which tools to call; Tranvoro runs the same checks it runs for a person using the app.
Look up
“Find our air shipment from JFK to TLV for this customer.” The assistant searches customers and shipments, then reads the file: route, schedule, cargo, tracking, documents, tasks and warnings. Tools: customer_search, shipment_search, shipment_get.
Update
“Change the ETA to 26 September at 03:00.” The update goes through Tranvoro's own validation, a stale edit is refused instead of overwriting a colleague, and the audit entry reads Source: MCP with the client's name. Tool: shipment_update.
Create
“Create an air import shipment from this booking confirmation, attach the PDF and add a follow-up task.” The assistant resolves the customer and airports, creates the shipment, uploads the document and creates the task. Tools: shipment_create, document_upload, task_create.
Report
“Compare this month's shipment volume and gross profit with last month.” You get volume, quotes, acceptance and conversion rates, revenue, cost and margin, each with the previous equivalent period. Tool: business_get_overview.
Spot problems
“Show critical exceptions for ocean imports arriving this week.” Overdue ETAs, missing documents and similar issues, most severe first, filtered by mode, direction and date. Tool: shipment_get_exceptions.
Know your customers
“Which customers have cut their shipment volume by more than 40%?” Customer performance, rankings, inactivity and trends. Financial figures need the right scope and role. Tools: customer_get_inactive, customer_get_rankings.
What the assistant can reach
Tranvoro exposes 64 tools plus a profile tool, read-only resources and ready-made prompts. Each tool calls the same operation the app calls, so numbering, status rules, notifications and the audit trail work exactly as they do for a person.
| Area | What an assistant can do | Access scope |
|---|---|---|
| Shipments | Search by number, customer, reference, route, mode, status or dates; read a full shipment; create and update shipments; set a status; add tracking events, notes, containers and packages | shipments:read / write |
| Quotes | Search and read quotes; create and update quotes and charge lines; preview then confirm conversion to a shipment | quotes:read / write |
| Customers and CRM | Search and manage customers, contacts and opportunities, with a duplicate check before creating a customer | crm:read / write |
| Documents | List documents and metadata, upload PDF, JPEG, PNG or WebP files up to 25 MB, copy a document onto another shipment | documents:read / write |
| Tasks | Search, create, update and complete tasks linked to shipments, quotes or customers | tasks:read / write |
| Charges and profitability | List and edit shipment charges, read shipment profitability and quote margins | financials:read / write |
| Business analytics | Shipment, quote and financial analytics with comparison to the previous period; route, customer and branch rankings | Matching read scopes |
| Customer insights and exceptions | Customer performance, rankings, inactive and declining customers, and shipment exceptions with a summary | Matching read scopes |
| Reference data | Airports, ports, locations, carriers, users, branches, charge types, currencies and allowed values | reference-data:read |
Four prompts help an assistant follow safe workflows: summarising a shipment for an internal or customer audience, creating a shipment from an email, creating a quote from an email, and checking a booking confirmation against a shipment. They tell the assistant to look up every reference, ask you instead of inventing ids, dates or routing, confirm before changes that matter, and treat pasted text as data rather than instructions.
Connect in a few minutes
Open Settings → MCP / AI Integrations in your workspace to see the exact MCP URL for your server. Claude and ChatGPT connect from their own servers, so the URL must be reachable over HTTPS.
In Settings → Connectors, choose Add custom connector, name it Tranvoro and paste the MCP URL. Leave the advanced client fields empty, then connect, sign in and approve. The connector then works across Claude on web, desktop and mobile, including Cowork. On Team and Enterprise plans an owner adds it for the organisation first.
Turn on Developer mode in ChatGPT settings, create a new app, paste the MCP URL and choose OAuth. If asked how to register the client, choose Client ID Metadata Document. Availability depends on your ChatGPT plan, and on Business or Enterprise an admin may need to allow custom apps.
Run claude mcp add --transport http tranvoro <your MCP URL>, then open /mcp and choose Authenticate. A personal access token also works, as it does for Cursor and your own agents.
Control and safety
Effective permission is the token's scope, intersected with your live Tranvoro role, inside one workspace. A scope never grants more than your role allows: a Viewer with a write scope still cannot edit a shipment, and branch-restricted users reach only their own branches. No tool accepts a workspace id, so one customer's data cannot be requested from another's connection.
Audit entries written during an MCP call are marked as coming from MCP with the client's name, and each write also records the tool, the target and the result. Tokens and file contents are never written to the audit log.
There is no tool for deleting records, bulk changes, free-form SQL, invoicing, payments or refunds. Status changes, conversion to a shipment and money writes are flagged as sensitive, and converting a quote needs an explicit confirmation step.
Create and add tools accept an idempotency key, so a retry does not create a duplicate. Updates can carry the record's last-updated time, and a change made on a stale copy is refused instead of overwriting a colleague's edit.
Tokens are stored only as hashes and shown once. Personal tokens can expire after 30 days, 90 days, a year or never, and a workspace can hold up to 50 active tokens. Disconnecting an app, or deactivating a user, cuts access off immediately; access is re-checked on every request.
Workspace administrators see every member's connected apps and can disconnect them, and a usage view in settings shows how the connection is being used. Rate limits apply per token and per workspace.
Who can connect, and what it costs
MCP needs your workspace's API access, which every plan includes; see pricing. Any internal team member can connect their own account, and the assistant then acts with that member's role. Workspace owners and administrators create personal access tokens. Customer-portal accounts cannot connect assistants.
Your AI assistant is a separate product: Claude, ChatGPT and Cursor each have their own plans, limits and terms, and Tranvoro does not control them. To see the workflow an assistant would work in, read about freight quoting and shipment documents, or how Tranvoro fits small freight forwarders.
MCP, the Model Context Protocol, is an open standard that lets AI assistants connect to other software through a defined set of tools. A Tranvoro workspace exposes its shipments, quotes, customers, documents, tasks and reports to a connected assistant, with the permissions of the person who connected it.
Claude (web, desktop, mobile and Cowork), ChatGPT in Developer mode, Claude Code and Cursor, plus any client that supports remote MCP servers over HTTP with OAuth sign-in or a bearer token.
No. Tranvoro has no MCP tool for deleting records, bulk edits, SQL, invoicing, payments or refunds.
Only if you approve a financial scope and your Tranvoro role is allowed to see those figures. Read-only Viewer roles never see them through MCP.
No. The workspace comes from the connection itself, tools take no workspace id, and a record from another workspace is reported as not found.
MCP depends on the API access feature, which is included in every published plan. Check that your workspace shows the MCP / AI Integrations page in Settings.
No. MCP lets the assistant you already use work in Tranvoro. Tranvoro supplies the tools, the permission checks and the audit trail; the AI model is Claude, ChatGPT or whichever client you connect.
Start a 30-day free trial, add a shipment and connect Claude or ChatGPT from Settings. No credit card required.