# How to connect Amplitude to AI agents?

Connect Amplitude to Sequel with an API key and ask about events, active users, retention, and funnels in natural language.

Connect **Amplitude** to Sequel and ask about your product analytics — events, active users, retention, funnels, and cohorts — in plain English, from the Sequel app or any AI tool wired up to the [MCP server](/docs/install). Then join it with your warehouse, revenue, or CRM data for questions a single tool can't answer alone.

## What you'll need

- An **Amplitude account** with access to the project you want to query.
- Your project's **API Key** and **Secret Key**, found under **Settings → Projects → [your project] → General**.
- The **region** your project lives in — **US** (amplitude.com) or **EU** (analytics.eu.amplitude.com).

<Callout type="tip" title="Where to find your keys">
In Amplitude, open **Settings → Projects**, pick your project, and the **General** tab shows the **API Key** and **Secret Key**. Read access to the project is enough — Sequel only uses these keys for read-only analytics queries.
</Callout>

## Connect it

<Steps>
<Step title="Copy your API & Secret Key">
In Amplitude, go to **Settings → Projects → [your project] → General** and copy both the **API Key** and **Secret Key**.
</Step>

<Step title="Open a new connection">
In the Sequel dashboard, go to **Connections → New connection**, choose **Amplitude**, and give it a name.
</Step>

<Step title="Paste your keys and pick a region">
Paste the **API Key** and **Secret Key**, then select your **region** (US or EU) — the one the project was created in. Sequel combines the two keys as HTTP Basic auth against Amplitude's read APIs.
</Step>

<Step title="Test & save">
Click **Test**. Sequel validates the keys against the Taxonomy API. When it confirms, save the connection and it goes live.
</Step>
</Steps>

## What you can query

Sequel exposes read-only tools over Amplitude's Taxonomy, behavioral query, and Dashboard APIs:

- **Events catalog** — list every event tracked in the project, including last-seen timestamps.
- **Event properties** — the full property list (and value samples) for any event.
- **Event segmentation** — counts, uniques, sums, and averages over any event, grouped or filtered by property.
- **Funnel reports** — conversion and drop-off across any step sequence and window.
- **Retention reports** — N-day, weekly, and monthly retention by cohort.
- **Saved charts** — re-pull an existing Amplitude chart by its chart ID and re-segment it.

The connector is read-only; it cannot create or modify events, charts, or cohorts.

## Try it

- "What's the 7-day retention for users who signed up last month?"
- "Show me the conversion funnel from signup to first paid action over the past 30 days."
- "Which onboarding step has the biggest drop-off?"
- "How many users triggered 'Subscription Started' last week, by plan?"

## Join it with other sources

> "Compare onboarding funnel conversion in Amplitude against MRR from Stripe by signup month."

## Troubleshooting

| Symptom | Likely fix |
| --- | --- |
| Test fails with a 401 / auth error | The API Key or Secret Key is wrong. Re-copy both from **Settings → Projects → General** — they're easy to swap. |
| Connects but returns empty results | The region is almost always the culprit. Switch between **US** and **EU** to match where the project was created, then re-test. |
| A report comes back with no data | No events fired in the date range. Widen the range or confirm the event name with a quick "list events" question. |

## Related

- [Connecting your first data source](/docs/connecting-your-first-data-source)
- [Chatting with your data](/docs/chatting-with-your-data)
- [Browse all integrations](/docs/integrations)