---
name: sequel
description: Discover and securely query your cloud databases, warehouses, product analytics, and SaaS tools through the Sequel MCP server — connect a source once, then read and analyze data from any MCP-capable agent.
version: 1.0.0
homepage: https://sequel.sh
---

# Query your data with Sequel

Sequel is the data layer for AI agents. It manages authentication, credentials,
and query execution so an agent can securely query cloud databases, data
warehouses, product analytics, and SaaS tools over the Model Context Protocol
(MCP). You connect a source once in Sequel; your agent talks to Sequel, and
Sequel talks to your data. Adding a new tool becomes a permission grant rather
than a secret-sharing exercise.

## Connect the MCP server

Sequel exposes a single streamable-HTTP MCP endpoint:

- **Endpoint:** `https://api.sequel.sh/mcp`
- **Auth:** `Authorization: Bearer <api_key>` (keys look like `sql_...`), or OAuth
  (the server advertises RFC 9728 / RFC 8414 metadata under
  `https://api.sequel.sh/.well-known/`).

Example install for Claude Code:

```bash
claude mcp add --transport http sequel https://api.sequel.sh/mcp --header "Authorization: Bearer sql_your_api_key"
```

Setup snippets for Cursor, VS Code, Windsurf, ChatGPT, Codex, Zed, Gemini and
more are at https://sequel.sh/docs/install.

## Tools

| Tool | Purpose |
| --- | --- |
| `sequel_manage_connections` | List your org's connections and start connecting a new source. |
| `sequel_search` | Discover available data sources and fetch an execution plan. Mints a `session_id`. |
| `sequel_execute` | Run a one-off query and write the result to a file. |
| `sequel_workbench` | Python/Bash sandbox (pandas, numpy, matplotlib; `import sequel`) for analysis. |
| `sequel_download_file` | Get a signed URL for a file produced during the session. |

## Typical flow

1. Call `sequel_search` to find the relevant source and get a plan. Keep the
   returned `session_id`.
2. Thread that `session_id` into `sequel_execute` and `sequel_workbench` so they
   share the same `/data` working context and file outputs.
3. Use `sequel_download_file` to retrieve any generated artifacts.

Sequel connects to cloud-hosted sources (e.g. RDS, Supabase, Neon, BigQuery,
Snowflake, ClickHouse, Google Analytics). Full documentation: https://sequel.sh/docs —
every page is also available as raw Markdown by appending `.md` to its URL.