Docs for AI tools

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	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	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	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 (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.

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 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:

Go to Organization settings → Connectors.
Click Add.
Hover over Custom, then select Web.
Paste the URL: /api/mcp.
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:

Ask an Owner to complete the steps above first — members can’t add custom connectors directly.
Once it’s added, go to Customize → Connectors.
Find “Hightouch Docs” in the list (labeled Custom).
Click Connect to authenticate and start using it.

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

Go to Customize → Connectors.
Click +, then Add custom connector.
Paste the URL: /api/mcp.
Click Add to finish.

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)

Quit Claude Desktop completely.
Open the config file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Add (or merge into) the mcpServers object:

{
  "mcpServers": {
    "hightouch-docs": {
      "type": "url",
      "url": "/api/mcp"
    }
  }
}

Save the file and relaunch Claude Desktop.
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:

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:

{
  "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?

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. 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 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 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 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 spec.

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.

Additional resources

API overview — REST API authentication and usage
API reference — Full API endpoint documentation
CLI overview — Command line interface for Hightouch
Events SDK — Track user events for real-time activation

Get started

Marketing

Data platform

Manage

Resources

API reference

Overview

MCP server

Endpoint

Available tools

Configuration

Claude

Custom connectors (recommended)

Config file (if you can’t add custom connectors)

Cursor

Other clients

Example prompts

Plain-text files

Skill file

Additional resources

​Overview

​MCP server

​Endpoint

​Available tools

​Configuration

​Claude

Custom connectors (recommended)

Config file (if you can’t add custom connectors)

​Cursor

​Other clients

​Example prompts

​Plain-text files

​Skill file

​Additional resources

Overview

MCP server

Endpoint

Available tools

Configuration

Claude

Cursor

Other clients

Example prompts

Plain-text files

Skill file

Additional resources