> ## 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 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](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:
### 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:
```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 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.