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:

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.

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

Endpoint

https://hightouch.com/docs/api/mcp

Available tools

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.
2. Click Add.
3. Hover over Custom, then select Web.
4. Paste the URL: https://hightouch.com/docs/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.
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.
2. Click +, then Add custom connector.
3. Paste the URL: https://hightouch.com/docs/api/mcp.
4. Click Add to finish.

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:

   {
     "mcpServers": {
       "hightouch-docs": {
         "type": "url",
         "url": "https://hightouch.com/docs/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:

claude mcp add --transport http hightouch-docs https://hightouch.com/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": "https://hightouch.com/docs/api/mcp"
    }
  }
}

Other clients

Use the endpoint URL https://hightouch.com/docs/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?

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:

https://hightouch.com/docs/llms.txt
https://hightouch.com/docs/llms-full.txt

Skill file

Hightouch publishes a skill file that gives AI tools a structured reference for writing code against the Hightouch platform. It covers REST API endpoints and authentication, CLI commands, Events SDK methods and setup snippets, sync modes and schedule types, and core data model concepts (sources, models, destinations, syncs).

Use this when you want an AI tool to generate correct API calls, CLI commands, or SDK integrations without searching the full docs. The file follows the Agent Skills spec.

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