Skip to main content

Cursor

Try Holistics CLI + Skills

For coding agents, the recommended setup is the Holistics CLI + Skills workflow rather than a standalone MCP connection. It sets up local AML development, CLI sync, and MCP access together in one step — the full local development experience, not just data Q&A.

Step 1: Enable MCP Server​

This is a one-time setup done by a workspace admin. Go to AI Settings and enable both Holistics AI and the MCP Server.

ai-mcp-setting

Step 2: Connect Cursor to Holistics MCP Server​

Cursor supports two ways to register the Holistics MCP server: Remote URL config and local command config. See Cursor MCP docs.

Remote URL config supports two authentication methods: OAuth and API key.

OAuth

  • Obtain connection URL from Step 3 and replace <MCP_SERVER_ADDRESS>. Cursor will prompt you to log in.
{
  "mcpServers": {
    "holistics": {
      "url": "<MCP_SERVER_ADDRESS>"
    }
  }
}

API key

  • Obtain connection URL from Step 3 and replace <MCP_SERVER_ADDRESS>
  • Obtain your API key from Step 4 and replace <YOUR_HOLISTICS_API_KEY>
{
  "mcpServers": {
    "holistics": {
      "url": "<MCP_SERVER_ADDRESS>",
      "headers": {
        "X-Holistics-Key": "<YOUR_HOLISTICS_API_KEY>"
      }
    }
  }
}

Local command config​

Only supports API key authentication.

  • Obtain connection URL from Step 3 and replace <MCP_SERVER_ADDRESS>
  • Obtain your API key from Step 4 and replace <YOUR_HOLISTICS_API_KEY>
{
  "mcpServers": {
    "holistics": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "<MCP_SERVER_ADDRESS>",
        "--header", "X-Holistics-Key:<YOUR_HOLISTICS_API_KEY>"
      ]
    }
  }
}

Step 3: Obtain connection URL​

Your connection URL depends on your data center region and the Holistics environment you want your AI to work with.

Select your data region

Select your working environment

Let your AI work with published Holistics objects — those on the Reporting tab.

Get your connection url

https://mcp-apac.holistics.io/reporting/mcp


URL format
https://mcp-<REGION>.holistics.io/<ENV>/mcp
  • <REGION>: Choose based on your data center: apac, eu, or us
  • <ENV>:
    • reporting (default): Let your AI work with published Holistics objects (i.e. objects on your Holistics Reporting tab)
    • development: Let your AI work with unpublished Holistics objects in your current AMQL project branch (i.e. objects on your Holistics Development tab)

Step 4: Obtain API key​

Find your key under Account settings in Holistics.

Holistics Account Settings page showing the API key location

Need more help?​

See the MCP FAQ for questions about permissions, data access, and security.

Open Markdown
Let us know what you think about this document :)