> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equals.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Equals MCP
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.
***
## 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](https://claude.ai/customize/connectors), 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:
```json theme={null}
{
"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:
```bash theme={null}
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:
```json theme={null}
{
"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:
```bash theme={null}
npx mcp-remote https://go.equals.com/api/mcp
```
4. Name it `equals`
5. Activate it via **MCP: List Servers**
Or add directly to your `settings.json`:
```json theme={null}
{
"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:
```json theme={null}
{
"mcpServers": {
"equals": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"]
}
}
}
```
***
## Zed
Open your settings (`Cmd + ,`) and add:
```json theme={null}
{
"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:
### 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:
```bash theme={null}
node --version
```
If you don't have it, download it from [here](https://nodejs.org').
#### 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 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.