The Primo MCP server lets AI assistants such as ChatGPT, Claude or Cursor work with your Factorial IT data. Use it when you want to ask about or manage your devices, employees and tickets in plain language from the assistant you already use.
Feature/Functionality
Overview
MCP (Model Context Protocol) is an open standard. It lets an AI assistant plug straight into outside tools and data, Factorial IT included.
Once connected, your assistant can read and act on your IT estate when you ask it to: list devices, find employees, manage accessories, open tickets and more.
What you need:
- A Factorial IT account with access to your company's workspace.
- An AI assistant that supports MCP, such as ChatGPT, Claude or Cursor.
Sign-in uses OAuth. When you add the server, the assistant sends you to sign in with your Factorial IT account. No API key is needed.
Server URL
The server lives at:
https://api.getprimo.com/mcpOut of the box the connection is read-only: the assistant can look at data but cannot change it.
For write access (opening tickets, updating accessories and so on), use this URL instead:
https://api.getprimo.com/mcp?readOnly=false
How to use: ChatGPT
- Open ChatGPT. Your plan must support custom MCP connectors.
- Go to Settings → Connected Apps, or use the "Connect" menu.
- Select Add MCP Server.
- Enter
https://api.getprimo.com/mcp. - Sign in with your Factorial IT account when the OAuth page opens.
- Authorise the connection.
Prompts to try:
- "List all devices managed in Factorial IT"
- "Show me employees who joined this month"
- "What tickets are currently pending?"
How to use: Claude Desktop
- Open the Claude Desktop app.
- Go to Settings → Developer → MCP Servers.
- Click Add Server.
- Give it a name (for example "Factorial IT") and enter
https://api.getprimo.com/mcp. - Complete the OAuth sign-in with your Factorial IT account.
- Save and reconnect. The Factorial IT tools now appear in Claude's toolbox.
How to use: Cursor
- Open the Cursor settings.
- Go to MCP Servers.
- Add a server with the URL
https://api.getprimo.com/mcp. - Complete the OAuth sign-in with your Factorial IT account. Cursor's assistant can then use the Factorial IT tools.
How to use: other assistants
Any app that follows the MCP standard can connect. Point it at https://api.getprimo.com/mcp and sign in with your Factorial IT account through OAuth.
Several companies on one account
If your account can reach more than one tenant, the server uses the company chosen in Default MCP company. You find it on the Companies tab of My account, which only appears when you belong to two or more companies.
When no default is set, add the x-company-id parameter to the URL:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_IDParameters can be combined:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=falseTo get your tenant ID, list your companies through the API or look at the URL in the console.
What the assistant can do
The assistant only sees the tools your role allows. It is limited to 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 | — |
| Catalogue | Search the catalogue and view products, favourites, shipping countries and company addresses; view the equipment and purchasing policies | Pin and unpin favourites; 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 disenrol; 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 enrolment 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 catalogue; 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 organisation 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 catalogue, the software on a device, install status and logs, and CVE vulnerabilities | Install, uninstall, update and delete software; update install scripts; sync the catalogue 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 and delete tickets; add comments; update status, priority, assignee and AI agent; manage subscribers, linked objects and ticket tags |
Be careful with write mode. Some actions cannot be reversed: wiping a device, permanently deleting a SaaS identity with its history, or deleting a ticket along with its tasks. If you want to keep a ticket's history, ask the assistant to close it rather than delete it.
Tips and Best Practices
-
Start read-only. Add
readOnly=falseonly when you actually need the assistant to change things. - Close tickets instead of deleting them. Deleting removes the ticket and its tasks for good.
- Double-check before a wipe. The assistant can wipe devices in write mode, and a wipe cannot be undone.
-
Set a default company if you manage several. It saves adding
x-company-idto every URL and avoids answers from the wrong tenant. - Give the right role. The assistant only gets the tools your role allows, so access is limited by the same rules as the console.
Troubleshooting and FAQ
Troubleshooting
- The URL shows "404 Not Found" in a browser. That is expected. The server is not a web page; it is an endpoint for AI assistants. Add it as an MCP server in your assistant instead.
- Authentication fails. Finish the OAuth sign-in when the assistant asks for it. Your Factorial IT account must be active and have access to the company you want to query.
-
The assistant shows data from the wrong company. Set Default MCP company on the Companies tab of My account, or add the
x-company-idparameter to the URL. -
The assistant cannot change anything. The connection is read-only by default. Reconnect with
readOnly=false.
FAQ
-
Do I need an API key?
No. You sign in with your Factorial IT account through OAuth.
-
Can the assistant make changes straight away?
No. It starts in read-only mode. Write access needs thereadOnly=falseURL.
-
Will the assistant see everything in the console?
No. It only sees the tools your role allows.
-
Where do I find my tenant ID?
List your companies through the API, or check the URL in the console.
-
Who do I contact for help with the setup?
Contact Factorial IT support or use the in-app chat. The API documentation is at api.getprimo.com/apidoc.