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

# Docs for AI tools

> Search and read Hightouch documentation from AI tools via MCP, plain-text files, and agent skills.

## Overview

Hightouch publishes documentation in formats that AI tools can read directly, so they have accurate and current information when answering questions or helping you build integrations. Choose the format that fits how your tool works:

| Format | Best for | How it works |
| :- | :- | :- |
| [MCP server](#mcp-server) | Targeted lookups from tools that support MCP | The tool searches for relevant sections and reads only the pages it needs. Uses fewer tokens because it doesn't load everything upfront. |
| [Plain-text files](#plain-text-files) | Broad context loading or tools without MCP support | Paste a URL to give your tool an index of all pages or the full content of every page in one file. |
| [Skills](#skills) | Implementation tasks (API calls, SDK setup, sync configuration) | A structured instruction file that helps tools work with the right endpoints, patterns, and parameters. |

## MCP server

For AI tools that support [Model Context Protocol](https://modelcontextprotocol.io) (MCP), Hightouch publishes an MCP endpoint with two tools: one to search across all public docs by keyword, and one to read the full content of a specific page. The tool retrieves only the sections relevant to your question rather than loading all documentation at once, which means faster responses and lower token usage.

> [!NOTE]
>
> This is a **docs-only** MCP server for searching and reading Hightouch
> documentation — it doesn't connect to your Hightouch workspace or take actions
> in your account. For an AI assistant that can build audiences, design
> journeys, and generate emails, ad creatives, and campaign concepts directly in
> your workspace, see the [Hightouch MCP](https://docs.hightouch.com/ai-integrations/mcp.md) instead.

The search index is rebuilt on every deployment, so results always reflect the latest content.

### Endpoint

```
/api/mcp
```

### Available tools

| Tool | Description |
| :- | :- |
| `search_docs` | Full-text search across all public docs with per-heading granularity. Returns matching sections with title, URL, content snippet, and section hierarchy. Supports filtering by product area. |
| `read_doc` | Returns the full markdown content of a documentation page by path. Use paths from `search_docs` results. |

### Configuration

Any MCP client that supports HTTP transport can connect using the endpoint URL. Below are setup instructions for common tools.

#### Claude

##### Custom connectors (recommended)

**If you're an Owner on a Team or Enterprise plan:**

1. Go to [Organization settings → Connectors](https://claude.ai/admin-settings/connectors).
2. Click **Add**.
3. Hover over **Custom**, then select **Web**.
4. Paste the URL: `/api/mcp`.
5. Click **Add** to finish — no OAuth client ID or secret is needed since the endpoint doesn't require authentication.

**If you're a member (not an Owner) on a Team or Enterprise plan:**

1. Ask an Owner to complete the steps above first — members can't add custom connectors directly.
2. Once it's added, go to [Customize → Connectors](https://claude.ai/customize/connectors).
3. Find "Hightouch Docs" in the list (labeled **Custom**).
4. Click **Connect** to authenticate and start using it.

**If you're on an individual Pro, Max, or Free plan:**

1. Go to [Customize → Connectors](https://claude.ai/customize/connectors).
2. Click **+**, then **Add custom connector**.
3. Paste the URL: `/api/mcp`.
4. Click **Add** to finish.

> [!NOTE]
>
> Free plan accounts are limited to one custom connector total. If you already
> have one configured, remove it before adding this one.

##### Config file (if you can't add custom connectors)

1. Quit Claude Desktop completely.

2. Open the config file:
   * macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
   * Windows: `%APPDATA%\Claude\claude_desktop_config.json`

3. Add (or merge into) the `mcpServers` object:

   ```json theme={null}
   {
     "mcpServers": {
       "hightouch-docs": {
         "type": "url",
         "url": "/api/mcp"
       }
     }
   }
   ```

4. Save the file and relaunch Claude Desktop.

5. Confirm the connector is live: open a chat, click the tools/connector icon, and check that "hightouch-docs" appears with `search_docs` and `read_doc` listed.

**Claude Code** — Run the following from your terminal:

```bash theme={null}
claude mcp add --transport http hightouch-docs /api/mcp
```

Verify with `claude mcp list` — you should see `hightouch-docs` with a connected status.

#### Cursor

Add the following to `.cursor/mcp.json` in your project:

```json theme={null}
{
  "mcpServers": {
    "hightouch-docs": {
      "type": "url",
      "url": "/api/mcp"
    }
  }
}
```

#### Other clients

Use the endpoint URL `/api/mcp` with Streamable HTTP transport. No authentication is required. Refer to your client's documentation for MCP configuration instructions.

### Example prompts

Once connected, your AI tool queries the docs automatically when you ask questions about Hightouch. Here are some examples to try:

**Sync configuration**

```
How do I set up a sync to Salesforce? What sync modes does it support?
```

```
What's the difference between upsert and mirror sync modes?
```

**Destinations and sources**

```
What permissions do I need to connect a Snowflake source?
```

```
Show me the field mapping options for the Braze destination.
```

**Troubleshooting**

```
I'm getting a "rate limit exceeded" error syncing to HubSpot. What should I check?
```

```
How do I use the Live Debugger to inspect API requests for a sync?
```

**Customer Studio**

```
How do I create a computed trait that counts purchases in the last 30 days?
```

```
What filter types are available in the audience builder?
```

> [!NOTE]
>
> The docs MCP server gives your AI tool access to Hightouch documentation. To
> also connect your AI assistant to your Hightouch workspace — to build
> audiences, create journeys, or generate content — add the [Hightouch
> MCP](https://docs.hightouch.com/ai-integrations/mcp.md). You can use both together for documentation
> reference and platform actions in the same conversation.

## Plain-text files

Hightouch publishes plain-text versions of the docs that any AI tool can read without parsing web page markup. Both files are regenerated on every deployment, so they always reflect the latest content. Use these when your tool doesn't support MCP or when you want to load broad context in a single request.

[**llms.txt**](https://docs.hightouch.com/llms.txt) is an index of every public page, organized by product area. Use this when you want an AI tool to know what documentation is available.

[**llms-full.txt**](https://docs.hightouch.com/llms-full.txt) contains the full text of every public page in a single file. Use this when you want an AI tool to have complete context about Hightouch.

To use either file, paste the URL into your AI tool:

```
/llms.txt
/llms-full.txt
```

## Skill file

Hightouch publishes a [skill file](https://docs.hightouch.com/skill.md) that summarizes what AI tools can do with Hightouch, the inputs they need, and the constraints that apply. It's generated from these docs and updates as they change.

Use it when you want an AI tool to work with Hightouch without searching the full docs. The file follows the [Agent Skills](https://agentskills.io/) spec.

> [!NOTE]
>
> The skill file is a reference for developer tooling. To connect an AI
> assistant to your Hightouch workspace for building audiences, creating
> journeys, or generating content, see [Hightouch MCP](https://docs.hightouch.com/ai-integrations/mcp.md).

## Additional resources

* [API overview](https://docs.hightouch.com/developer-tools/api-guide.md) — REST API authentication and usage
* [API reference](https://docs.hightouch.com/api-reference.md) — Full API endpoint documentation
* [CLI overview](https://docs.hightouch.com/developer-tools/cli-guide.md) — Command line interface for Hightouch
* [Events SDK](https://docs.hightouch.com/events/overview.md) — Track user events for real-time activation