Equals MCP

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

Claude

Team, Enterprise

Adding the Equals MCP server to your Claude team will allow anyone on your team to connect Equals to their Claude sessions.

You must be an Owner in your Claude team to add a custom connector.

Visit the the Connectors page, then click the + button and select “Add custom connector”:

Then enter “Equals” as the Name, and https://go.equals.com/api/mcp as the Remote MCP Server URL, and then click Add.

Users can then enable the Equals connector in their Claude sessions. This will open a browser tab to authenticate in Equals to establish the connection.

Free, Pro

Go to Settings → Developer and click “Edit config”:

This will open the location of the claude_desktop_config.json file. Open this file with a text editor and add the following:

{
  "mcpServers": {
    "equals": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"]
    }
  }
}

This should live alongside any existing preferences, like so:

Save this file, then 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)

Open the Command Palette (Ctrl/Cmd + Shift + P) and run MCP: Add Server
Select Command (stdio)
Enter:

npx mcp-remote https://go.equals.com/api/mcp

Name it equals
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

Open Settings (Ctrl/Cmd + ,)
Scroll to Cascade → MCP Servers
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:

What You Can Do

Once connected, your AI assistant can:

Find Workbooks

Search workbooks in your Equals workspace by name or content, and list your team’s trusted workbooks — curated, vetted analyses that are surfaced first as the most reliable sources to reference.

Query Datasources

List connected datasources, explore their schema, and directly run SQL queries.

Ask Equals

Ask questions about your data in natural language. The Equals agent can query all your connected datasources and read any workbook you have access to, and runs its own analysis to find answers. You can ask follow-up questions in the same conversation, and answers can include a full workbook you can open in Equals. Ask Equals consumes Equals AI credits.

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.

Windows

If you are on Windows, you may need to replace "command": "npx", with "command": "C:\\Program Files\\nodejs\\npx.cmd",.

Tool Calls Time Out

The Equals agent 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.

Getting Started

Connect and transform data

Explore data

Analyze data

Report on data

Claude

Team, Enterprise

Free, Pro

Claude Code

Cursor

VS Code (GitHub Copilot)

Windsurf

Zed

Other Tools

What You Can Do

Find Workbooks

Query Datasources

Ask Equals

Troubleshooting

Authentication Errors

`npx mcp-remote` Not Found

Windows

Tool Calls Time Out

​Claude

​Team, Enterprise

​Free, Pro

​Claude Code

​Cursor

​VS Code (GitHub Copilot)

​Windsurf

​Zed

​Other Tools

​What You Can Do

​Find Workbooks

​Query Datasources

​Ask Equals

​Troubleshooting

​Authentication Errors

​npx mcp-remote Not Found

​Windows

​Tool Calls Time Out

Claude

Team, Enterprise

Free, Pro

Claude Code

Cursor

VS Code (GitHub Copilot)

Windsurf

Zed

Other Tools

What You Can Do

Find Workbooks

Query Datasources

Ask Equals

Troubleshooting

Authentication Errors

`npx mcp-remote` Not Found

Windows

Tool Calls Time Out