What is MCP?
The Model Context Protocol (MCP) is an open standard that allows AI assistants like ChatGPT, Claude, or Cursor to connect directly to external tools and data sources — including Primo. With the Primo MCP server, your AI assistant can query and manage your IT fleet in natural language: list devices, look up employees, manage accessories, create tickets, and more.Prerequisites
To use the Primo MCP server, you just need:- A Primo account with access to your company’s workspace
- An AI assistant that supports MCP (ChatGPT, Claude, Cursor, etc.)
MCP server URL
The Primo MCP server is available at:Setup guide
ChatGPT
- Open ChatGPT (Plus or Team plan required)
- Go to Settings → Connected Apps or use the “Connect” menu
- Select “Add MCP Server”
- Enter the server URL:
https://api.getprimo.com/mcp - You’ll be redirected to sign in with your Primo account (OAuth)
- Authorize the connection — you’re all set!
- “List all devices managed in Primo”
- “Show me employees who joined this month”
- “What tickets are currently pending?”
Claude Desktop
- Open the Claude Desktop app
- Go to Settings → Developer → MCP Servers
- Click “Add Server”
- Enter a name (e.g. “Primo”) and the URL:
https://api.getprimo.com/mcp - Complete the OAuth sign-in flow with your Primo account
- Save and reconnect — Primo tools will appear in Claude’s toolbox
Cursor
- Open Cursor settings
- Navigate to MCP Servers
- Add a new server with the URL:
https://api.getprimo.com/mcp - Complete the OAuth authentication with your Primo account
- Primo tools will be available in Cursor’s AI assistant
Other MCP-Compatible Clients
Any application that supports the MCP standard can connect to Primo. Use the server URLhttps://api.getprimo.com/mcp — authentication is handled via OAuth.
Multi-company support
If your organization manages multiple companies in Primo, the MCP server defaults to your primary company. To target a specific company, add thex-company-id parameter to the URL:
To find your company ID, use the API to list your companies or check the URL in your Primo dashboard.
What can you do?
Once connected, your AI assistant can perform the following actions through Primo:| Category | Read Operations | Write Operations |
|---|---|---|
| Accessories | List and view accessories | Create and update accessories |
| Company | View authenticated company details | — |
| Devices | List, search, and view device details | Create, lock, unlock, wipe (⚠️) |
| Device Groups | List and view device groups | — |
| Employees | List and view employee profiles | Create employees |
| MDM Controls | List and view MDM controls | — |
| SaaS | List and view SaaS applications | Update SaaS contracts |
| Software | List and view softwares | — |
| Tickets | List, search, filter, and view tickets | Create tickets, add comments, update status/priority/assignee |
Troubleshooting
“404 Not Found” when opening the URL in a browser This is normal. The MCP server is not a web page — it’s a protocol endpoint designed to be used by AI assistants. Add it as an MCP server in your preferred client. Authentication error Make sure you complete the OAuth sign-in flow when prompted. You need an active Primo account with access to the company you want to query. Data from the wrong company If you manage multiple companies, specify the target company using thex-company-id parameter (see Multi-Company Support above).