Skip to main content
The Equals MCP server gives AI assistants direct access to your Equals workspace. You can search workbooks and ask the Equals AI Analyst questions about your data.

​
Setup

The Equals MCP server uses OAuth 2.1 for authentication. The server is available at: https://go.equals.com/api/mcp When you connect for the first time, your AI tool will open a browser window to log in to Equals and authorize the connection.

​
Claude Desktop

Claude Desktop doesn’t yet support remote MCP servers natively. Use the mcp-remote bridge instead. Add the following to your claude_desktop_config.json (find it under Claude settings → Developer): 
{
  "mcpServers": {
    "equals": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"]
    }
  }
}
Restart Claude Desktop. On first use, a browser window will open to authorize the connection.

​
Claude Code

Run the following in your terminal: 
claude mcp add --transport http equals https://go.equals.com/api/mcp
Then run /mcp inside a Claude Code session to authenticate.

​
Cursor

Open Cursor Settings → MCP, then add a custom server: 
{
  "mcpServers": {
    "equals": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"]
    }
  }
}

​
VS Code (GitHub Copilot)

  1. Open the Command Palette (Ctrl/Cmd + Shift + P) and run MCP: Add Server
  2. Select Command (stdio)
  3. Enter:
npx mcp-remote https://go.equals.com/api/mcp
  1. Name it equals
  2. Activate it via MCP: List Servers
Or add directly to your settings.json: 
{
  "mcp": {
    "servers": {
      "equals": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"]
      }
    }
  }
}

​
Windsurf

  1. Open Settings (Ctrl/Cmd + ,)
  2. Scroll to Cascade → MCP Servers
  3. Add a custom server:
{
  "mcpServers": {
    "equals": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"]
    }
  }
}

​
Zed

Open your settings (Cmd + ,) and add: 
{
  "context_servers": {
    "equals": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"],
      "env": {}
    }
  }
}

​
Other Tools

Any MCP client that supports remote servers or the mcp-remote bridge can connect using: https://go.equals.com/api/mcp

​
What You Can Do

Once connected, your AI assistant can:

​
Search Workbooks

Find workbooks in your Equals workspace by name or content.

​
Ask the Analyst

Ask questions about your data in natural language. The Analyst queries your connected databases, builds charts, and creates workbooks.

​
Continue a Conversation

Follow up on previous Analyst threads with additional questions.

​
Troubleshooting

​
Authentication Errors

Make sure you have an active Equals account and that your workspace has MCP enabled. Try disconnecting and reconnecting to go through the authorization flow again.

​
npx mcp-remote Not Found

Make sure Node.js is installed: 
node --version
If you don’t have it, download it from here.

​
Tool Calls Time Out

The Analyst can take 1–5 minutes to answer complex questions. Your AI tool should poll for results automatically; if it gives up early, try asking it to wait and check again.