Connect MCP

https://intelligence-backend.gethelium.co/mcp

OAuth (Google / magic link). Not org API keys. After connect, use pim_* tools — same module/op as POST /v1/{module}. HTTP apps still use Auth + skill pim/http-api.

URLs

Health: GET {API}/mcp/health.

Claude Desktop

1. Settings → Connectors → Custom connector.
2. Paste the URL.
3. Allow OAuth. Login page is the PIM web app (/login).
4. Tools appear as pim_organisations, pim_workspaces, pim_generate, pim_models, pim_research, …

Cursor

~/.cursor/mcp.json (or project .cursor/mcp.json):

{
  "mcpServers": {
    "helium-pim": {
      "url": "https://intelligence-backend.gethelium.co/mcp"
    }
  }
}

Local:

{
  "mcpServers": {
    "helium-pim": {
      "url": "http://localhost:3001/mcp"
    }
  }
}

Restart Cursor. Complete OAuth when prompted.

First calls

Do not invent ops. Tool schemas = catalog.

{ "op": "list" }

pim_workspaces then pick workspaceId.

{ "op": "author", "workspaceId": "<uuid>", "resourceTypeId": "<uuid>", "prompt": "PDP title from attrs" }

{ "op": "image", "workspaceId": "<uuid>", "prompt": "Studio packshot on white", "model": "openai/gpt-image-2" }

HTTP skill for apps: pim_skills({ "op": "get", "skillId": "pim/http-api" }) or resource pim://skill/pim/http-api.