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

# Attribution MCP

> A dedicated MCP connector for agent-driven attribution — query who's been on your site, follow their journeys, read acquisition and conversion analytics, and act on it (link a visitor to a contact, configure Google conversions).

The Attribution MCP is a focused connector for one job: **let an AI agent query who's been on your site and act on it.** It exposes your [visitors](/docs/mintlify/analytics/visitors), their journeys, and your [attribution analytics](/docs/mintlify/analytics/attribution) as tools — plus a couple of write tools to turn a visitor into a contact or wire up [server-side conversions](/docs/mintlify/analytics/conversions).

## Connector URL

```txt theme={null}
https://mcp.sapt.ai/attribution/mcp
```

It uses OAuth, exactly like the [main Sapt connector](/docs/mintlify/mcp/overview). Add it as a custom connector in Claude, ChatGPT, or any MCP client, sign in with your Sapt account, and the tools target your active workspace.

<Note>
  This is a narrow, attribution-only surface. If you want broad access to a Project (content, CRM, social, ads, email), use the all-in-one [Sapt connector](/docs/mintlify/mcp/sapt) instead — or add both.
</Note>

## Setup

### Claude

1. Open [Claude connectors](https://claude.ai/customize/connectors?modal=add-custom-connector).
2. Click **Add custom connector**.
3. Name it `Sapt Attribution`.
4. Paste `https://mcp.sapt.ai/attribution/mcp`.
5. Click **Connect** and authorize with your Sapt account.

### ChatGPT

1. Open **Settings → Apps → Advanced settings** and turn on **Developer mode**.
2. **Create app**, name it `Sapt Attribution`.
3. Paste `https://mcp.sapt.ai/attribution/mcp`, set authentication to **OAuth**, and create.

## Tools

| Tool                         | What it does                                                                                                                |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `getLiveVisitors`            | Visitors active on your site right now.                                                                                     |
| `getVisitors`                | Recent visitors with their identity status (anonymous / identified / contact) and per-visitor stats.                        |
| `getVisitorTimeline`         | The full event timeline for a single visitor.                                                                               |
| `getContactJourney`          | The unified journey for a CRM contact — web activity and CRM activity in one timeline.                                      |
| `getAcquisition`             | First-touch acquisition: visitors, sessions, and pageviews by the source / medium / campaign that originally acquired them. |
| `getUtmBreakdown`            | Per-event UTM rollups across `utm_source`, `utm_medium`, `utm_campaign`, and friends.                                       |
| `getConversions`             | Conversions broken down by source, campaign, and landing page.                                                              |
| `getConversionFunnel`        | The pageview → engaged → form\_submit → lead funnel with step conversion rates.                                             |
| `getLeadTime`                | Lead time-to-conversion — how long from first touch to becoming a lead.                                                     |
| `getTraffic`                 | Overall site traffic.                                                                                                       |
| `linkVisitorToContact`       | Turn an identified visitor into a CRM contact, attaching their full prior history. The programmatic **Add to CRM**.         |
| `getGoogleConversionsSetup`  | Read the current Google Ads server-side conversions configuration.                                                          |
| `configureGoogleConversions` | Connect Google Ads and pick the conversion action that recorded conversions upload to.                                      |

<Warning>
  `linkVisitorToContact` and `configureGoogleConversions` change live data and live ad-platform configuration. Confirm intent before calling them — everything else here is read-only and safe to call freely.
</Warning>

## Typical flows

* **Lead triage.** `getVisitors` to find identified visitors who haven't been contacted → `getVisitorTimeline` to read what they looked at → `linkVisitorToContact` to add the promising ones to the CRM.
* **Channel review.** `getAcquisition` and `getConversions` to compare which sources bring traffic versus which bring leads → `getLeadTime` to see how fast each channel pays off.
* **Recover ad attribution.** `getGoogleConversionsSetup` to check whether Google server-side conversions are wired up → `configureGoogleConversions` to connect Google Ads and pick a conversion action.

## Keep going

<CardGroup cols={2}>
  <Card title="Visitors & identity" href="/docs/mintlify/analytics/visitors" description="The dashboard view behind these tools." />

  <Card title="Attribution analytics" href="/docs/mintlify/analytics/attribution" description="The reports getAcquisition, getConversions, and getLeadTime return." />

  <Card title="Server-side conversions" href="/docs/mintlify/analytics/conversions" description="What configureGoogleConversions sets up." />

  <Card title="MCP Overview" href="/docs/mintlify/mcp/overview" description="All Sapt MCP connectors and how to add them." />
</CardGroup>