Connect to our MCP

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.)

The Primo MCP server uses OAuth for authentication. When you add it to your AI assistant, the assistant redirects you to sign in with your Primo account. You don’t need an API key.

MCP server URL

The Primo MCP server is available at:

https://api.getprimo.com/mcp

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:

https://api.getprimo.com/mcp?readOnly=false

Setup guide

ChatGPT
Claude Desktop
Cursor
Other clients

Open ChatGPT

Use a plan that supports custom MCP connectors.

Go to Settings → Connected Apps

Or use the “Connect” menu.

Select Add MCP Server

Enter the server URL

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

You’re redirected to the OAuth sign-in.

Authorize the connection

Example prompts:

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

Open the Claude Desktop app

Go to Settings → Developer → MCP Servers

Click Add Server

Enter a name and the URL

Enter a name (e.g. “Primo”) and the URL https://api.getprimo.com/mcp.

Complete the OAuth sign-in flow

Save and reconnect

Primo tools appear in Claude’s toolbox.

Open Cursor settings

Navigate to MCP Servers

Add a new server

Use the URL https://api.getprimo.com/mcp.

Complete the OAuth authentication

Any application that supports the MCP standard can connect to Primo. Use the server URL https://api.getprimo.com/mcp and sign in with your Primo account through OAuth.

Multi-tenant support

If your account has access to multiple tenants, the MCP server defaults to the company set in Default MCP company, on the Companies tab of My account. The tab appears when you belong to two companies or more. If no default tenant is set, you can specify one by adding the x-company-id parameter to the URL:

https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID

You can combine parameters:

https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=false

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 use the following Primo tools. It only sees the tools your Primo role allows, and only the read operations until you connect with readOnly=false.

Category	Read operations	Write operations
Accessories	List and view accessories and their custom fields	Create, update, assign, and archive accessories; set custom field values
Admins	List the company admins	Email the company admins
AI Agents	List agents and their runs; read a run’s report and transcript	Create a custom agent; replace an agent’s instructions
AI Dashboards	View a dashboard and its instructions	Recompose a dashboard; replace its instructions
AI Tools	View the AI tools found on devices, the risk findings, and the AI tools settings	Approve or block AI tools; update the settings
AI Usage	View the company’s AI credit usage	—
Billing Profiles	List billing profiles	—
Catalog	Search the catalog and view products, favorites, shipping countries, and company addresses; view the equipment and purchasing policies	Pin and unpin favorites; update and publish the equipment and purchasing policies
Company	View the company and its metrics report	—
Compliance	List and search compliance alerts with their remediation context; view alert rules, settings, and the remediation policy	Create and update alert rules; update the settings; update, publish, and unpublish the remediation policy
Custom Fields	List and view custom fields	Create, update, and archive custom fields
Device Groups	List and view device groups and what uses them; check a target before creating a group	Create, update, and delete device groups
Devices	Search, count, and view devices with their activities, MDM commands, local accounts, and custom fields; export devices and inventory as CSV	Create, update, and delete devices; lock, unlock, wipe (⚠️), reboot, retire, and disenroll; move to stock or in use; run a script; resend a profile; set tags and custom field values
Employees	List, search, and view employees and their custom fields	Create, update, hide, and unhide employees; send an enrollment request; set custom field values
Knowledge Base	List and view knowledge base items	Create, update, publish, unpublish, and delete items
MDM Controls	List, view, and browse the type catalog; list the controls that apply to a device	Create, update, delete, and update tags
Offboardings	List and view offboardings	—
Onboardings	List and view onboardings and the onboarding settings	Create, complete, and ignore onboardings; run the employee, email account, equipment, and SaaS steps; update the settings
Orders	List and view orders and their custom fields	Create orders and equipment orders; set custom field values
SaaS	List and view SaaS, their issues, and each employee’s identities; preview what the rules grant	Provision, deprovision, create, link, archive, and delete identities; reset a password; manage groups, roles, licences, and organization units; update contracts, owners, approval status, and rules
Scripts	List saved scripts and their runs, with the result on each device	Run a script on a target
Shipments	List and view shipments	Create a shipment
Software	View the software catalog, the software on a device, install status and logs, and CVE vulnerabilities	Install, uninstall, update, and delete software; update install scripts; sync the catalog or a device
Tasks	List tasks	Create and schedule tasks; update their status and assignee
Tickets	List, count, and view tickets with their subscribers; list ticket tags	Create tickets and comments; update status, priority, assignee, and AI agent; manage subscribers, linked objects, and ticket tags

Some write operations can’t be undone, such as wiping a device or permanently deleting a SaaS identity and its history. 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 Default MCP company on the Companies tab of My account, 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

Get started

API Reference

What is MCP?

Prerequisites

MCP server URL

Setup guide

Multi-tenant support

What can you do?

Troubleshooting

”404 Not Found” when opening the URL in a browser

Authentication error

Data from the wrong tenant

Need help?

​What is MCP?

​Prerequisites

​MCP server URL

​Setup guide

​Multi-tenant support

​What can you do?

​Troubleshooting

​”404 Not Found” when opening the URL in a browser

​Authentication error

​Data from the wrong tenant

​Need help?

What is MCP?

Prerequisites

MCP server URL

Setup guide

Multi-tenant support

What can you do?

Troubleshooting

”404 Not Found” when opening the URL in a browser

Authentication error

Data from the wrong tenant

Need help?