MCP Integration | Tailor AI

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external tools and data sources. When you connect Tailor via MCP, your AI assistant can read your traffic data, review experiment results, query enrichment data, pull ads performance, and even take actions like starting or stopping experiments.

This means you can ask questions like "Which campaigns drove the most conversions last week?" or "Show me enterprise visitors who hit our pricing page" and get answers directly from your Tailor data, without switching tools.

Note: Tailor's MCP integration is a work in progress and likely to evolve as we add new capabilities. Claude's MCP configuration flows may also change over time. The setup details below are meant as examples only. If something looks different from what you see, check the Tailor settings page or reach out to support.

Setup

Step 1: Find your MCP URL

Go to Settings → Integrations → Connected Apps. Your MCP URL is displayed at the top:

https://mcp.tailorhq.ai

Step 2: Connect your client

Claude Code

claude mcp add tailor https://mcp.tailorhq.ai --transport http

You'll be prompted to authorize access in your browser the first time.

Using an API key instead (for CI/CD or headless environments)

claude mcp add tailor https://mcp.tailorhq.ai --transport http --header "Authorization: Bearer YOUR_API_KEY"

Claude.ai or Claude Desktop

In Claude's UI, go to Admin Settings → Connectors → Add custom connector, enter Tailor as the name and https://mcp.tailorhq.ai as the Remote MCP server URL, then click Add.

Alternative: edit the config file directly

Open Claude Desktop → Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "tailor": {
      "url": "https://mcp.tailorhq.ai",
      "transport": "http"
    }
  }
}

For API key auth, add "headers": { "Authorization": "Bearer YOUR_API_KEY" } inside the tailor object.

Other MCP clients

Any MCP-compatible client (Cursor, Windsurf, custom agents) can connect using https://mcp.tailorhq.ai with HTTP transport and either OAuth or an API key.

Step 3: Verify

Once connected, you'll see your connection with a CONNECTED status in Settings → Integrations → Connected Apps. Each connection has independent Read and Write toggles.

Available tools

All tools are available automatically once connected. Click a category to see what's included.

Traffic and analytics▶

tailor_traffic — Breakdowns by source, campaign, keyword, device, referrer, or locale with conversion rates
tailor_conversions — Conversion goal rates, most-clicked elements, and form submissions
tailor_engagement — Scroll depth and time-on-page metrics per landing page
tailor_visitor_journey — Full event timeline for a specific visitor

Experiments▶

tailor_experiments — List and view A/B test experiments
tailor_variants — Inspect individual variant configurations and copy changes
tailor_metrics — Per-variant performance (impressions, conversions, conversion rates)
tailor_goals — List conversion goals configured for experiments
tailor_recommendations — AI-generated next-best-action recommendations

Visitor enrichment▶

tailor_enrichment — Company-level visitor data (industry, size, revenue, role, location)
tailor_usage — Enrichment credit usage and daily volume metrics

Ads and analytics platforms▶

tailor_google_ads — Google Ads campaigns, ad groups, ads, keywords, search terms, and landing page spend
tailor_meta_ads — Meta (Facebook/Instagram) campaigns, ad sets, and ads performance
tailor_amplitude — Amplitude event analytics and cross-platform experiment attribution

Monitoring and alerts▶

tailor_traffic_guard — Traffic Guard alerts and custom rules for spend and CPA anomalies
tailor_inbox — Pending action items (recommendations, alerts, experiment issues)
tailor_competitors — Monitor competitor domains, URLs, and page changes
tailor_competitor_reports — AI-generated competitor analysis reports

Write actions (requires Write permission)▶

tailor_experiment_actions — Start, stop, or ramp experiments
tailor_experiment_setup — Create experiments, set primary goals, delete experiments
tailor_variant_manage — Create, delete, or restore variants
tailor_goal_manage — Create, update, delete, or attach conversion goals
tailor_recommendation_actions — Accept or dismiss AI recommendations

Flexible query▶

tailor_query — Structured analytics queries with custom groupings, filters, and aggregations on Tailor or Amplitude data

Account and integrations▶

tailor_organization — Organization details, Slack settings, enrichment config
tailor_slack — Slack integration status and channel configuration
tailor_landing_pages — All landing pages being tested or optimized
tailor_dashboard — High-level summary: active experiments, pending recommendations, recent winners

Example prompts

Try these in Claude Code, Claude Desktop, or any MCP-connected assistant.

Review experiment results

"Review all active experiments. For each one, show me the variant performance, conversion rates, and whether Tailor has a recommendation to ramp or stop."

Tools: tailor_experiments, tailor_metrics, tailor_recommendations

Full-funnel data analysis

"Compare Google Ads and Meta Ads performance for the last 30 days. Show me spend, landing page traffic, and downstream Amplitude conversions. Which campaigns have the best cost per qualified conversion?"

Tools: tailor_google_ads, tailor_meta_ads, tailor_traffic, tailor_amplitude

Identify and qualify enterprise visitors

"Pull identified visitors from /enterprise and /contact-sales for the last 7 days. Filter to enterprise companies in software or financial services. Score by engagement and show company name, industry, size, and visitor role. Rank by fit."

Tools: tailor_enrichment, tailor_engagement, tailor_query

Monitor performance and catch issues

"Check if there are any Traffic Guard alerts or inbox items I should look at. If there are traffic anomalies, dig into which campaigns or sources are affected."

Tools: tailor_traffic_guard, tailor_inbox, tailor_traffic

Competitive intelligence

"Show me recent changes to competitor landing pages. What messaging or positioning shifts should I know about?"

Tools: tailor_competitors, tailor_competitor_reports

Building agentic workflows

Beyond interactive use, you can embed Tailor's MCP tools into automated pipelines using any MCP client library with an API key. Some ideas:

Weekly experiment digest

Pull active experiment results and pending recommendations, post a summary to Slack with suggested next actions.

Lead qualification pipeline

Pull identified visitors from high-intent pages daily, filter by ICP criteria, score by engagement, push qualified leads to CRM or Slack.

Cross-platform performance report

Combine Google Ads spend, Tailor site traffic, and Amplitude downstream conversions into a unified cost-per-conversion report.

Automated experiment management

Monitor results daily. When Tailor recommends ramping a winner, ramp it automatically with safety checks and Slack notifications.

Permissions and safety

Each connection has independent Read and Write toggles. Destructive write actions (stopping or deleting experiments) require a two-step confirmation token to prevent accidental changes.

Interactive analysis

Start with Read only. Enable Write when you're ready to take actions.

Automated reporting

Read only. No risk of accidental changes.

Experiment management

Read + Write, with confirmation steps and Slack notifications in your workflow.

Troubleshooting

"Tool not found" or no tools available

Verify the connection shows as CONNECTED in Settings → Integrations → Connected Apps. If not, re-run the connection command.

Write actions are rejected

Check that the Write toggle is enabled for your connection in Settings → Integrations → Connected Apps.

No data returned

Most tools require a date range. Make sure you're querying dates with active traffic, and that the relevant integration (Google Ads, Meta Ads, Amplitude) is connected.