Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getprimo.com/llms.txt

Use this file to discover all available pages before exploring further.

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

  1. Open ChatGPT (Plus or Team plan required)
  2. Go to Settings → Connected Apps or use the “Connect” menu
  3. Select “Add MCP Server”
  4. Enter the server URL: https://api.getprimo.com/mcp
  5. You’ll be redirected to sign in with your Primo account (OAuth)
  6. Authorize the connection — you’re all set!
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 in Primo, 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: 
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
You can set your default MCP tenant in My Account → AI Settings → Default MCP Tenant to avoid passing x-company-id every time.
To find your tenant 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:
CategoryRead OperationsWrite Operations
AccessoriesList and view accessoriesCreate and update accessories
CompanyView authenticated company details—
DevicesList, search, and view device detailsCreate, update assignee, lock, unlock, wipe (⚠️)
Device GroupsList and view device groups—
EmployeesList and view employee profilesCreate employees
MDM ControlsList and view MDM controls—
SaaSList and view SaaS applicationsUpdate contracts, provision and deprovision identities
SoftwareList and view softwares—
AdminsList workspace admins—
TicketsList, search, filter, and view ticketsCreate tickets, add comments, update status/priority/assignee
Device actions (lock, wipe) are powerful and 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 above).

​
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