Blog
guide

How to Connect Amplitude to Grok Bot Using Sequel

Musthaq Ahamad
Musthaq Ahamad
How to Connect Amplitude to Grok Bot Using Sequel

Amplitude's behavioural reports are excellent and slow to assemble, which is why most teams rebuild the same funnel every quarter. Grok Bot is xAI's bot builder, an agent that keeps context and reaches your tools through plugins. Connect Amplitude through Sequel and the bot runs segmentation, funnel, and retention queries from a sentence.

TL;DR

What you're connectingAn Amplitude project to Grok Bot
Setup timeAbout 5 minutes
Setup methodOne chat message. Grok Bot has no MCP config file
Auth to AmplitudeAPI Key and Secret Key as HTTP Basic
Auth to the botOAuth to Sequel. No key in the chat
Also neededThe project's region, US or EU
Access levelRead-only

What You'll Accomplish

Once this is wired up, you can ask your bot:

  • "What's the 7-day retention for users who signed up last month?"
  • "Show the signup to first paid action funnel over the past 30 days."
  • "Which onboarding step has the biggest drop-off, and has it moved?"

Prerequisites

  • A Sequel account: sign up free at sequel.sh
  • An Amplitude project you can read
  • Your project's API Key and Secret Key from Settings → Projects → General
  • The project's region: US or EU
  • A Grok account with a bot you can send messages to

Step 1: Connect Amplitude to Sequel

In Amplitude, open Settings → Projects → [your project] → General and copy both the API Key and Secret Key.

Then sign in to sequel.sh, open Data Sources, click New Connection, and choose Amplitude.

Choose a connector

FieldWhat to enter
Connection NameA memorable label, for example Mobile App Amplitude
API KeyFrom the project's General settings
Secret KeyFrom the same page. The two are easy to swap, so check
RegionUS for amplitude.com, EU for analytics.eu.amplitude.com

Click Test. Sequel validates the keys against the Taxonomy API and the connection goes live.

What you get, all read-only:

ToolWhat it returns
Events catalogEvery event in the project, with last-seen timestamps
Event propertiesProperty list and value samples for any event
Event segmentationCounts, uniques, sums, averages, grouped or filtered
Funnel reportsConversion and drop-off across any step sequence
Retention reportsN-day, weekly, and monthly retention by cohort
Saved chartsRe-pull an existing chart by ID and re-segment it

Step 2: Add Sequel to Grok Bot

Grok Bot has no MCP config file and no settings form to fill in. You add a server by asking the bot.

Open a chat with your bot and send this:

Add a custom MCP server called sequel at https://api.sequel.sh/mcp

Say custom server explicitly. Leave those words out and the bot searches the plugin marketplace instead of registering your endpoint.

Sequel's Grok Bot install card

The bot reads the name and URL back to you. Check both, confirm, and it posts a connect card in the chat. Click Authorize, sign in to Sequel, and approve access. The OAuth token stays on the connector side, so there is no API key to copy and nothing to keep in sync.

To confirm it registered, open Settings → Plugins → Yours. Every server on your account is listed there, including the ones you added by chat.

Grok's plugins panel

Then attach it to a task: type @ in the chat and pick sequel.

Using Grok chat rather than a bot? The steps do not carry over. On grok.com, open Plugins → New Connector → Custom, set the name to Sequel and the Server URL to https://api.sequel.sh/mcp, click Add Connector, and sign in.

Grok custom connector form

Step 3: Ask Grok Bot About Your Amplitude Data

Attach @sequel and ask:

What's the 7-day retention for users who signed up last month, by acquisition channel?
Show the signup to first paid action funnel for the past 30 days and name the biggest drop-off.
How many users triggered Subscription Started last week, broken down by plan?

What You Can Do Now

  • Retention questions in one message: cohort, window, and breakdown described in a sentence.
  • Scheduled product digests: the bot runs unattended, so weekly activation and retention arrive on their own.
  • Onboarding diagnosis: find the step that loses the most users and whether it got worse.
  • Chart re-cuts: "that saved chart, but split by plan" without rebuilding it.
  • Cross-source joins: compare Amplitude activation against MRR from Stripe by signup month.

Troubleshooting

SymptomLikely fix
The bot searched the marketplace instead of adding the serverResend the message with the words "custom server" in it.
The server is not listed under Settings → Plugins → YoursThe registration did not complete. Resend the message and confirm the name and URL when the bot reads them back.
The bot answers without touching your dataYou did not attach it. Type @ in the chat and pick sequel before asking.
Test fails with a 401API Key and Secret Key are swapped or wrong. Re-copy both from the project's General settings.
Connects but returns empty resultsSwitch the region between US and EU to match where the project was created.
A report has no dataNo events fired in the range. Widen it, or list events first to confirm the exact name.

Related Guides

Try Sequel

Build your company brain.

Sequel connects the systems your company runs on and learns how your team defines every metric, so any AI agent can answer from it. Free for up to 3 seats, no credit card required.

Get started free

Frequently asked questions

How do I add Sequel to Grok Bot?

Ask the bot. Send "add a custom MCP server called sequel at https://api.sequel.sh/mcp", confirm the name and URL it reads back, then click Authorize on the connect card and sign in to Sequel. Say "custom server" explicitly so the bot adds the endpoint instead of searching the plugin marketplace.

Do I need a Sequel API key for Grok Bot?

No. Sequel is a remote MCP server with OAuth. The bot posts a connect card, you authorize in the browser, and the token stays on the connector side. There is no key to paste into a chat.

Is this the same as Grok chat or Grok Build?

No, and the steps do not carry over. Grok chat on grok.com adds servers under Plugins, New Connector, Custom. Grok Build is the terminal coding agent and uses grok mcp add. Grok Bot is the bot builder, where you add servers by asking the bot.

Which Amplitude keys do I need?

Your project's API Key and Secret Key, both under Settings, Projects, your project, General. Read access to the project is enough.

Why does my connection return empty results?

Region is almost always the cause. Amplitude projects live in US (amplitude.com) or EU (analytics.eu.amplitude.com). Switch the region in Sequel to match where the project was created.

Can the bot create or change Amplitude charts?

No. The connector is read-only. It cannot create or modify events, charts, or cohorts.

Can I re-pull an existing Amplitude chart?

Yes. Sequel can fetch a saved chart by its chart ID and re-segment it, which is useful when a stakeholder asks for "that chart but by plan".

Can I connect several Amplitude projects?

Yes. Each project is its own connection in Sequel, and your bot can query all of them.

Written by

Musthaq Ahamad
Musthaq Ahamad

Co-founder and CEO of Sequel. Previously built developer tools and data infrastructure. Passionate about making data accessible for everyone.