Magic Dispatch MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Magic Dispatch MCP server
Read-only access to your Magic Dispatch account from AI tools that run local MCP servers: Claude Desktop, Claude Code, Cursor, VS Code (Copilot), Windsurf, Gemini CLI and others. Ask things like "which routes did Sam finish this week?", "where is order 4812?" or "compare deliveries by driver for the last two weeks".
Tools
All tools only read data (GET requests). Nothing is created, changed or deleted.
Tool | What it returns |
| Companies your email belongs to and which one is selected (works without signing in) |
| Signed-in user, role, company and its time zone |
| Staff and drivers, filtered by role or search |
| Teams (vehicles) with travel method and drivers |
| Routes in a date range, filtered by status, driver or team (by name) |
| One route with its stops in order |
| Orders list, newest first, like the dashboard Orders page; filter by status, search, dates or priority |
| Customers or vendors with contact details, filter by status or search |
| Products and services with price, filter by type or search |
| Delivery status for a tracking number |
| Delivery counts per driver or team, daily/weekly/monthly |
| Payment transactions in a date range, with total |
| Magic Dispatch service invoices per month |
How the tools behave:
Names, not just ids. Pass "Sam" or "North team". If several match, the tool lists them and asks which one.
Compact pages. 25 rows by default, with
next_cursorfor more.Company time zone. "Today" is today in your company's time zone, not UTC.
Role-aware. Driver and customer logins are refused, as in the dashboard. Customer service logins don't get
get_transactions,monthly_billing_summaryorlist_users.Audit. Every API call carries
X-Client-Source: mcp.
Related MCP server: Company Data MCP Server
Install
You need Node.js 20 or newer (node --version). Nothing else: the server is a single bundled file with no dependencies to install.
Every install asks for the same three settings. The server connects to the Magic Dispatch staging API (https://api-staging.magicdispatch.com/api/v2); there is no URL to enter. Production isn't used yet, so use your staging login.
Setting | Env variable | Example |
| Your Magic Dispatch login email | |
Password |
| Your Magic Dispatch password |
Company |
| The company you sign in to, by name ( |
Use a dispatcher, management or customer service login. Driver and customer logins are refused.
Find your company
Like the dashboard login, one email can belong to several companies, and you pick one. To see yours before installing:
npx -y @magicdispatch/mcp companies you@example.comCompanies for you@example.com:
139 Acme Delivery
212 Beta Foods (driver login, can't be used)
Set "Company" to one of these names or IDs.Already installed with the wrong company? Ask your AI tool "list my Magic Dispatch companies". The list_companies tool works without signing in and shows which one is selected. Sign-in errors also list your companies.
Claude Desktop (one click)
Download
magic-dispatch-<version>.mcpbfrom the latest release.Double-click it (or drag it onto Claude Desktop, or Settings → Extensions → Install Extension).
Fill in email, password and company, then enable it.
Claude Desktop stores the password in your system keychain.
Claude Code
claude plugin marketplace add Triangle-Empire/magic-dispatch-mcpclaude plugin install magic-dispatch@magic-dispatch-toolsThen, in a Claude Code session:
/plugin configure magic-dispatch@magic-dispatch-toolsThe password is stored in your system keychain.
Cursor, Windsurf, Gemini CLI, Claude Desktop (manual) and other MCP clients
These clients start the server with npx, which downloads it from npm on first run. Add this block to the client's config file:
Client | Config file |
Cursor |
|
Windsurf |
|
Gemini CLI |
|
Claude Desktop |
|
{
"mcpServers": {
"magic-dispatch": {
"command": "npx",
"args": ["-y", "@magicdispatch/mcp"],
"env": {
"MAGIC_EMAIL": "you@example.com",
"MAGIC_PASSWORD": "your-password",
"MAGIC_COMPANY_ID": "Acme Delivery"
}
}
}
}Restart the client after saving. These files keep the password in plain text, so don't commit or share them.
VS Code (GitHub Copilot agent mode)
Add .vscode/mcp.json to your project. VS Code asks for the password once and stores it securely, so it never sits in the file:
{
"inputs": [
{"type": "promptString", "id": "magic-password", "description": "Magic Dispatch password", "password": true}
],
"servers": {
"magic-dispatch": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@magicdispatch/mcp"],
"env": {
"MAGIC_EMAIL": "you@example.com",
"MAGIC_PASSWORD": "${input:magic-password}",
"MAGIC_COMPANY_ID": "Acme Delivery"
}
}
}
}Without npm (from a clone)
Clone the repo and point the client at the bundled file instead of npx. No npm install needed. The company lookup works the same way: node dist/server.js companies you@example.com.
"command": "node",
"args": ["/path/to/magic-dispatch-mcp/dist/server.js"]Not supported yet
ChatGPT, claude.ai (web and mobile) and other cloud-hosted assistants. They only connect to remote MCP servers over HTTPS with OAuth. That needs the hosted connector, which depends on backend OAuth work.
Check it works
Ask your AI tool "Who am I in Magic Dispatch?". It should call whoami and answer with your name, role and company. If it reports a setup error, the message says which setting to fix and, for a company problem, lists your companies.
What it sends, and where
The server logs in to the Magic Dispatch API only (
https://api-staging.magicdispatch.com/api/v2,POST /users/auth/), keeps the session cookie in memory, and logs in again once if the session expires.It logs tool name, duration and success to stderr: never arguments, results or credentials.
No data is sent anywhere else.
Development
npm installnpm test # unit + mocked-API tests, no networknpm run test:bundle # build dist/server.js and start it like an MCP client wouldnpm run inspect # MCP Inspector against the real API (set the MAGIC_* variables)To use a local backend, or production once it's enabled, set MAGIC_API_URL (for example https://api.magicdispatch.com/api/v2). Install forms don't ask for it; it's for development only.
npm run validate # validate the Claude Code pluginCode lives in server.js and lib/. Clients run the bundle dist/server.js, which is committed: run npm run build and commit dist/ (including THIRD_PARTY_LICENSES.txt) with every code change.
Releasing
Set the same version in
package.json,manifest.json,.claude-plugin/plugin.jsonandserver.js.npm run build, then commit (includingdist/server.js) and push.npm run mcpbbuildsmagic-dispatch.mcpb. Attach it to a GitHub release namedv<version>, renamed tomagic-dispatch-<version>.mcpb.npm publish --access publicpublishes@magicdispatch/mcp(runs build and all tests first). Needs themagicdispatchnpm organization.
License
MIT. dist/server.js bundles third-party packages under MIT, ISC and BSD-3-Clause licenses; their notices are in dist/THIRD_PARTY_LICENSES.txt, regenerated by every build.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Query your org's data in natural language — read-only MCP access to SQL, NoSQL, files & warehouses.
Read-only access to your Drivara fleet — jobs, drivers, vehicles, fuel, profit & analytics.
Read-only delivery, dispatch, route and fleet tools for Lastmile workspaces.
Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides read-only access to databases for MCP-compatible AI tools, allowing schema exploration and SELECT queries without exposing credentials or risking data changes.3-
- FlicenseNot gradedqualityDmaintenanceEnables read-only access to company data across PostgreSQL, MongoDB Atlas, and flat files through MCP tools, allowing AI assistants to query and retrieve information via natural language.-
- AlicenseNot gradedqualityCmaintenanceA read-only MCP gateway that enables AI agents to retrieve business data (sales, appointments, clients, inventory, etc.) from the AURON Suite backend with role-based access control, audit logging, and rate limiting.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants and LLM agents to query operational databases through a read-only MCP gateway with table whitelisting, automatic row limits, sensitive-data masking, and audit logging.1MIT