Get started

This guide walks you through connecting The Org’s MCP server to Claude Desktop or Cursor so you can query org charts, managers, positions, and usage from your AI assistant.

Prerequisites

API key – Create one in Manage subscription (Developers section).
Node.js – Required if you use mcp-remote to connect Claude Desktop to the remote MCP server.

💡

Credits for requests performed through the MCP server are deducted from the same credit balance as your other API usage.

Claude Desktop

To set up your Claude Desktop assistant, add this entry to your claude_desktop_config.json file.

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

With API key in config (replace YOUR_API_KEY):


{
  "mcpServers": {
    "theorg": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.theorg.com/v1.1/mcp",
        "--header",
        "X-Api-Key: YOUR_API_KEY"
      ]
    }
  }
}

With API key in an environment variable (recommended):


{
  "mcpServers": {
    "theorg": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.theorg.com/v1.1/mcp",
        "--header",
        "X-Api-Key:${THEORG_API_KEY}"
      ],
      "env": {
        "THEORG_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop after changing the config.

Cursor

Cursor has integrated support for MCP servers:

Go to Cursor > Settings > Cursor Settings > MCP
Click Add new global MCP server
Add the following configuration:


{
  "mcpServers": {
    "theorg": {
      "type": "streamableHttp",
      "url": "https://api.theorg.com/v1.1/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your API key. Restart Cursor if the server does not show up.

Integration with AI assistants

Once the MCP server is connected, you can ask your assistant to:

Fetch an org chart – e.g. “Get the org chart for theorg.com” or “Show me the org chart for [company]”
Find a manager – e.g. “Who is the manager of andreas@theorg.com?”
Search positions – e.g. “Find marketing people at Apple” (with filters)
Check usage – e.g. “How many API credits do I have left?”

The assistant will call the appropriate MCP tools and return the data. Ensure your API key has enough credits for the operations you request.