Guides

Chatting with your data

Once a source is connected, you can ask questions in plain English — from the Sequel app or from any AI tool wired up to the MCP server. This page covers what the agent can do and how to get the most out of it.

What the agent can do

Behind the scenes, Sequel exposes a small set of tools that the AI agent calls to answer your question:

CapabilityWhat it's for
Discover connectionsList the data sources available to you.
Search schemasFind the right tables and columns and plan a query.
Run queriesExecute read queries and return sample results.
Python workbenchRun Python (pandas, matplotlib, and more) in an isolated sandbox for analysis and charts.
Download filesExport results — CSVs, charts — produced in the workbench.

You don't call these directly. You ask a question; the agent chains the tools to answer it.

Ask better questions

  • Be specific about the metric and window. "Weekly active users for the last 90 days" beats "how are we doing."
  • Name the source when it's ambiguous. "In our Postgres orders table…" removes guesswork.
  • Ask for the format you want. "Return a table" or "plot it as a line chart."

Start broad to orient the agent ("what tables relate to subscriptions?"), then drill in. The agent keeps context across the conversation.

Join across sources

This is where Sequel shines. Because every connection is available in one place, a single question can span systems:

"Compare 90-day retention for users acquired through paid vs organic channels, using signups from Postgres and acquisition source from Google Analytics."

The agent searches both schemas, runs the queries it needs, and combines the results — no manual exports or copy-paste between tools.

Run real analysis with the workbench

When SQL isn't enough, the agent can run Python in a sandbox:

"Pull last quarter's order values and plot a histogram with the median marked."

The workbench has common data libraries available and runs in isolation. Generated files (charts, CSVs) can be downloaded directly from the conversation.

Same data, every tool

The connections you set up power every surface equally — the Sequel app, Claude, Cursor, ChatGPT, and any other MCP client. Set a source up once and ask about it from wherever you work.

Next steps