> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sixtyfour.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect Sixtyfour intelligence tools and docs to your AI assistant using the Model Context Protocol.

Sixtyfour provides two MCP servers:

| Server                   | URL                             | Auth             |
| ------------------------ | ------------------------------- | ---------------- |
| `sixtyfour-docs`         | `https://docs.sixtyfour.ai/mcp` | None required    |
| `sixtyfour-intelligence` | `https://mcp.sixtyfour.ai/mcp`  | API key or OAuth |

## Setup

The `sixtyfour-docs` server requires no authentication. The `sixtyfour-intelligence` server requires either an API key or OAuth for authentication.

### Cursor

<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=sixtyfour-intelligence&config=eyJ1cmwiOiJodHRwczovL21jcC5zaXh0eWZvdXIuYWkvbWNwIn0=">
  <img src="https://img.shields.io/badge/Install_with_one_click-Cursor-000000?style=for-the-badge&logo=cursor&logoColor=white&labelColor=555555" alt="Install in Cursor" noZoom />
</a>

Or add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project) manually. Replace `YOUR_API_KEY` with your key.

```json theme={null}
{
  "mcpServers": {
    "sixtyfour-docs": {
      "url": "https://docs.sixtyfour.ai/mcp"
    },
    "sixtyfour-intelligence": {
      "url": "https://mcp.sixtyfour.ai/mcp?api_key=YOUR_API_KEY"
    }
  }
}
```

<Tip>Cursor also supports OAuth for the intelligence server. If you omit the API key, Cursor will authenticate via an OAuth browser flow on first use.</Tip>

```json theme={null}
{
  "mcpServers": {
    "sixtyfour-intelligence": {
      "url": "https://mcp.sixtyfour.ai/mcp"
    }
  }
}
```

### VS Code

<a href="vscode:mcp/install?%7B%22name%22%3A%22sixtyfour-intelligence%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.sixtyfour.ai%2Fmcp%22%7D">
  <img src="https://img.shields.io/badge/Install_with_one_click-VS_Code-0066B8?style=for-the-badge&logo=visualstudiocode&logoColor=white&labelColor=555555" alt="Install in VS Code" noZoom />
</a>

Or add to `.vscode/mcp.json` in your project root manually. Replace `YOUR_API_KEY` with your key.

```json theme={null}
{
  "servers": {
    "sixtyfour-docs": {
      "type": "http",
      "url": "https://docs.sixtyfour.ai/mcp"
    },
    "sixtyfour-intelligence": {
      "type": "http",
      "url": "https://mcp.sixtyfour.ai/mcp?api_key=YOUR_API_KEY"
    }
  }
}
```

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`. Replace `YOUR_API_KEY` with your key.

```json theme={null}
{
  "mcpServers": {
    "sixtyfour-docs": {
      "url": "https://docs.sixtyfour.ai/mcp"
    },
    "sixtyfour-intelligence": {
      "url": "https://mcp.sixtyfour.ai/mcp?api_key=YOUR_API_KEY"
    }
  }
}
```

<Tip>
  After saving the configuration, reload your MCP servers or restart your IDE.
</Tip>

### Claude Code

Run these commands in your terminal. Add `--scope user` to make a server available across all projects.

**Docs MCP**

```bash theme={null}
claude mcp add --transport http sixtyfour-docs "https://docs.sixtyfour.ai/mcp"
```

**Intelligence MCP — OAuth (recommended)**

Claude Code will prompt you to authenticate via browser on first use:

```bash theme={null}
claude mcp add --transport http sixtyfour-intelligence "https://mcp.sixtyfour.ai/mcp"
```

**Intelligence MCP — API key**

```bash theme={null}
claude mcp add --transport http sixtyfour-intelligence "https://mcp.sixtyfour.ai/mcp?api_key=YOUR_API_KEY"
```

### Codex

Install via the [Sixtyfour Codex plugin](https://github.com/sixtyfour-ai/sixtyfour-codex-plugin), or add the servers to `~/.codex/config.toml` manually.

#### Plugin install

Register the marketplace, then install the plugin. Start a new Codex session after installing — plugins load at session start.

**Codex CLI:**

```bash theme={null}
codex plugin marketplace add sixtyfour-ai/sixtyfour-codex-plugin
codex plugin add sixtyfour@sixtyfour
```

Check installed plugins with `codex plugin list`.

**ChatGPT desktop app:**

1. Run the marketplace command above from a terminal.
2. Open the Plugins Directory (Work mode or Codex → Plugins), select the **Sixtyfour** marketplace, and install the plugin. If the marketplace is not listed, restart the app and try again.
3. Restart the ChatGPT desktop app if prompted after installing.

<Note>
  Plugins require ChatGPT Work mode or Codex — they aren't available in standard Chat, the IDE extension, or mobile. Work mode currently requires a Pro, Pro Lite, Enterprise, or Edu plan. On Enterprise, Edu, and Business workspaces, an admin must allow installing marketplace plugins under Workspace Settings → Plugins before it appears for members.
</Note>

<Tip>
  On first use, authenticate the intelligence server. In the Codex CLI, run `codex mcp login sixtyfour-intelligence` when prompted. In the ChatGPT desktop app, the sign-in prompt appears automatically.
</Tip>

#### Manual config

Add the servers to `~/.codex/config.toml`, then restart Codex and sign in when prompted.

**Docs MCP:**

```toml theme={null}
[mcp_servers.sixtyfour-docs]
command = "npx"
args = ["-y", "mcp-remote", "https://docs.sixtyfour.ai/mcp"]
```

**Intelligence MCP:**

```toml theme={null}
[mcp_servers.sixtyfour-intelligence]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.sixtyfour.ai/mcp"]
```

### Claude Desktop

In Claude Desktop, add two custom connectors:

| Name                     | Remote MCP server URL           |
| ------------------------ | ------------------------------- |
| `Sixtyfour Docs`         | `https://docs.sixtyfour.ai/mcp` |
| `Sixtyfour Intelligence` | `https://mcp.sixtyfour.ai/mcp`  |

Claude Desktop handles authentication for the intelligence server via OAuth on first connection.

### Smithery

Install the `sixtyfour-intelligence` server through [Smithery](https://smithery.ai/servers/sixtyfour/sixtyfour-intelligence), which handles configuration for Claude Desktop and other supported clients.

1. Open the [Sixtyfour Intelligence listing on Smithery](https://smithery.ai/servers/sixtyfour/sixtyfour-intelligence).
2. Select your client (for example, Claude Desktop) and follow the install command Smithery provides.
3. On first use, authenticate via OAuth or paste your Sixtyfour API key when prompted.

***

## Documentation MCP reference

The `sixtyfour-docs` server gives your AI assistant direct access to Sixtyfour API references, guides, and code examples.

| Tool                                               | Purpose                                                                   |
| -------------------------------------------------- | ------------------------------------------------------------------------- |
| `search_sixtyfour_ai_documentation`                | Semantic search across Sixtyfour docs                                     |
| `query_docs_filesystem_sixtyfour_ai_documentation` | Read specific pages and run `rg`/`cat`/`tree` against the docs filesystem |

**Example prompts**

* *"How do I use the company-intelligence endpoint?"*
* *"What parameters does find-email accept?"*
* *"Show me an example of using webhooks with Sixtyfour."*

***

## Intelligence MCP reference

The `sixtyfour-intelligence` server exposes tools across four categories.

**Account**

| Tool                      | Purpose                                          |
| ------------------------- | ------------------------------------------------ |
| `sixtyfour_check_balance` | Return the organization's current credit balance |

**Company search**

| Tool                                      | Purpose                                                |
| ----------------------------------------- | ------------------------------------------------------ |
| `sixtyfour_company_get_searchable_fields` | List all filterable field names for company search     |
| `sixtyfour_company_explore_field_values`  | Get top values for a field (e.g. valid industry names) |
| `sixtyfour_company_search`                | Search companies with a MongoDB-style filter query     |
| `sixtyfour_company_next_page`             | Fetch the next page of company search results          |
| `sixtyfour_company_get_company_details`   | Expand a result handle into full company data          |

**People search**

| Tool                                     | Purpose                                           |
| ---------------------------------------- | ------------------------------------------------- |
| `sixtyfour_people_get_searchable_fields` | List all filterable field names for people search |
| `sixtyfour_people_explore_field_values`  | Get top values for a field                        |
| `sixtyfour_people_search`                | Search people with a MongoDB-style filter query   |
| `sixtyfour_people_next_page`             | Fetch the next page of people search results      |
| `sixtyfour_people_get_person_details`    | Expand a result handle into full person data      |

**Async enrichment and contact lookup**

| Tool                                   | Purpose                                                                        |
| -------------------------------------- | ------------------------------------------------------------------------------ |
| `sixtyfour_company_intelligence_start` | Start a company intelligence job — returns a `task_id`                         |
| `sixtyfour_people_intelligence_start`  | Start a people intelligence job — returns a `task_id`                          |
| `sixtyfour_find_email_start`           | Find email addresses for 1–100 leads — returns a `task_id`                     |
| `sixtyfour_find_phone_start`           | Find phone numbers for 1–100 leads — returns a `task_id`                       |
| `sixtyfour_reverse_email_start`        | Resolve the person behind one or more email addresses — returns a `task_id`    |
| `sixtyfour_reverse_phone_start`        | Resolve the person behind one or more phone numbers — returns a `task_id`      |
| `sixtyfour_enrichment_job_status`      | Poll any `_start` tool's `task_id` until `completed`, `failed`, or `cancelled` |
| `sixtyfour_enrich_linkedin`            | Enrich a single LinkedIn profile or company URL — returns the result directly  |

Tools ending in `_start` submit a job and return a `task_id`. Poll `sixtyfour_enrichment_job_status` with that `task_id` until the response shows `completed`. The completed response includes `result`, `charge_amount`, and `task_type`.

`sixtyfour_enrich_linkedin` is synchronous — it returns the result directly.

<Warning>
  Enrichment start tools create billable jobs. If a call times out, do not retry blindly — the job may still have been created. Check status with `sixtyfour_enrichment_job_status` first.
</Warning>

**Example prompts**

* *"Search for US SaaS companies with 100–5000 employees."*
* *"Research Sixtyfour — return headquarters, headcount, funding stage, and key executives."*
* *"Enrich this person: Saarth Shah, CEO & Co-Founder at Sixtyfour."*
* *"Find the CTO and VP of Engineering at Sixtyfour."*
* *"Find the work email for Saarth Shah at Sixtyfour."*
* *"Find a phone number for Jane Doe, VP of Sales at Acme Corp."*
* *"Who owns the email [jane@acme.com](mailto:jane@acme.com)?"*
* *"How many Sixtyfour credits do I have left?"*