Skip to main content

​
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 need:
  • A Primo account with access to your company’s workspace
  • An AI assistant that supports MCP (ChatGPT, Claude, Cursor, etc.)
Authentication is handled via OAuth — when you add the Primo MCP server to your AI assistant, you’ll be redirected to sign in with your Primo account. No API key required.

​
MCP server URL

The Primo MCP server is available at:
By default, the server runs in read-only mode — your AI assistant can query data but cannot make changes. To enable write access (create tickets, update accessories, etc.), use:

​
Setup guide

1

Open ChatGPT

Use a plan that supports custom MCP connectors.
2

Go to Settings → Connected Apps

Or use the “Connect” menu.
3

Select Add MCP Server

4

Enter the server URL

Enter https://api.getprimo.com/mcp.
5

Sign in with your Primo account

You’re redirected to the OAuth sign-in.
6

Authorize the connection

Example prompts:
  • “List all devices managed in Primo”
  • “Show me employees who joined this month”
  • “What tickets are currently pending?”

​
Multi-tenant support

If your account has access to multiple tenants, the MCP server defaults to the tenant configured in your Default MCP Tenant setting (found in My Account > AI Settings). If no default tenant is set, you can specify one by adding the x-company-id parameter to the URL:
You can combine parameters:
To find your tenant ID, use the API to list your companies or check the URL in the cockpit.

​
What can you do?

Once connected, your AI assistant can perform the following actions through Primo:
Device actions (lock, wipe) are irreversible. Use write mode with caution.

​
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 tenant

If you have access to multiple tenants, set your default tenant in My Account > AI Settings > Default MCP Tenant, or specify the target tenant using the x-company-id parameter (see Multi-tenant support).

​
Need help?

Contact your Primo support team or reach out via the in-app chat if you need assistance setting up MCP. For API documentation, visit: api.getprimo.com/apidoc