Sequential MCP server
Commit Nov 11, 2026Lets an AI agent analyze user sessions, error logs, product analytics, and detected cases to understand user behavior and friction points.
Also known as usesequential/mcp, mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 11, 2026
- License
- MIT
What is Sequential MCP?
Sequential lets an AI agent analyze user sessions, error logs, product analytics, and detected cases to understand user behavior and friction points.
Summary generated from the project's README
About Sequential MCP server
Sequential provides an MCP server that allows AI agents to access website session replays and product analytics. This hosted service enables developers to connect agents like Claude Code, ChatGPT, and Cursor to their user data without local installation. By using streamable HTTP transport, the server gives agents visibility into user behavior, friction points, and technical failures.
Depending on the connection method, users can authenticate via a project access token or a direct sign-in. For example, Claude Code and Cursor typically use a token, while Claude.ai and ChatGPT utilize a sign-in process. The available tools vary based on the token scope, allowing agents to read cases, session summaries, JavaScript errors, and analytics such as funnels or retention. Some configurations even permit agents to link pull requests or commits to specific detected cases.
Written from the project's README. Every use case is checked against a quote from it.
How to install Sequential MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Sequential MCP in Claude Code
$ claude mcp add --transport http mcp https://api.usesequential.com/mcpInstall Sequential MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://api.usesequential.com/mcp"
}
}
}Install Sequential MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://api.usesequential.com/mcp"
}
}
}Install Sequential MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://api.usesequential.com/mcp"}'Install Sequential MCP in Codex
$ codex mcp add mcp --url https://api.usesequential.com/mcpInstall Sequential MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://api.usesequential.com/mcp"
Install Sequential MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://api.usesequential.com/mcpInstall Sequential MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://api.usesequential.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableusesequential/mcp is public and reachablegithub.com/usesequential/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/usesequential/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubSequential MCP server
Sequential is session replay and product analytics for websites and web apps. Its MCP server lets your agent read what happened to your users: cases, sessions, verdicts, errors, funnels and retention.
This repository holds the connection settings for each MCP client. The server itself is hosted. There is nothing to install or run.
- Endpoint:
https://api.usesequential.com/mcp - Read-only endpoint:
https://api.usesequential.com/mcp/readonly. No tool that writes is listed there. - Transport: Streamable HTTP
- Tools: Agent tools
What your agent can do
- Read cases: the problems that Sequential detected on its own, ranked by impact, each with its evidence, sample sessions and a fix brief.
- Read sessions: summaries, timelines, verdicts, and the sessions where people struggled.
- Read errors: JavaScript errors and failed network requests, grouped by cause.
- Read analytics: event counts, breakdowns, funnels, paths and retention.
- Ask: search sessions by a description, such as "tried to pay, gave up".
- With the scope for it, link a fix: link a pull request, commit or issue to a case.
The scopes of your token, or the access that you choose when you sign in, decide which tools your agent gets.
Get a token
Most coding agents connect with a project access token. Claude Code can also connect with a sign-in to Sequential (see below).
- Sign in to Sequential. Only owners and admins of the project's organisation can create a token.
- Open Agents, or the Access tokens tab of your project's settings.
- Create a token. The preset Agent: read everything, plus Ask is a good start.
- Copy the token. Sequential shows it only once. Treat it like a password: never commit it, and never put it in a shared chat or a ticket.
claude.ai and ChatGPT do not use a token. They connect with a sign-in to Sequential (see below).
Connect your client
Each config below goes in your user-level config, not in a file inside a repository. Replace <token> with your token, or set the environment variable SEQUENTIAL_TOKEN where the config reads it.
Claude Code
claude mcp add --transport http --scope user sequential https://api.usesequential.com/mcp --header "Authorization: Bearer <token>"
Then start a new Claude Code session. A server that you add with --scope user does not load into the session that added it. File: configs/claude-code.sh.
To connect with a sign-in instead of a token, run the same command without --header. In a new session, open the /mcp menu and choose sequential, then Authenticate. A Sequential page opens in your browser: choose one project or all projects of an organisation, and choose the access. Click Allow only if you started this sign-in yourself. Guide: Connect Claude Code.
claude.ai
In claude.ai, open Customize → Connectors. Click Add and add a custom connector. Paste https://api.usesequential.com/mcp and leave the advanced settings empty. A Sequential window opens: sign in, choose one project or all projects of an organisation, and choose the access. Guide: Connect claude.ai.
ChatGPT
In ChatGPT on the web, open Plugins in the left rail. Click Add, then Add custom MCP server. Name it "Sequential", paste https://api.usesequential.com/mcp as the Server URL and choose OAuth. Tick I understand and want to continue, then click Create as a plugin. Click Connect, then Connect Sequential. Sequential opens: sign in, choose one project or all projects of an organisation, and choose the access. There is no token.
Your ChatGPT plan must let you add a custom MCP server. ChatGPT Plus can add it. Business and Enterprise/Edu workspaces get every tool, and an admin or owner of the workspace adds the server. On Pro, ChatGPT uses only the tools that read. Free and Go cannot add a custom server. Guide: Connect ChatGPT.
Cursor
Add configs/cursor-mcp.json to ~/.cursor/mcp.json. Cursor reads the token from the environment variable SEQUENTIAL_TOKEN (${env:SEQUENTIAL_TOKEN}).
Codex
Add configs/codex-config.toml to ~/.codex/config.toml. Codex reads the token from SEQUENTIAL_TOKEN (bearer_token_env_var).
Claude Desktop
Add configs/claude-desktop.json to claude_desktop_config.json (Settings → Developer → Edit Config), then quit and open Claude Desktop again. It needs Node.js: it runs mcp-remote to reach the hosted server.
Cline
Add configs/cline_mcp_settings.json to Cline's MCP settings. Step-by-step: llms-install.md.
Gemini CLI
Add configs/gemini-cli-settings.json to ~/.gemini/settings.json. Gemini CLI reads the token from the environment variable SEQUENTIAL_TOKEN (${SEQUENTIAL_TOKEN}).
Other MCP clients
Most clients take a URL and headers: configs/other-clients.json. Key names vary by client.
Check the connection
Ask your agent: "Using Sequential, give me an overview of the last 7 days." The agent calls get_overview.
| You see | Cause | What to do |
|---|---|---|
| 401, or "The access token is unknown, revoked or expired" | The token is wrong, revoked or expired. | Create a new token and put it in the config. |
| "Tool not available for this token" | The token's scopes do not include that tool. On /mcp/readonly, no tool that writes is available. |
Use a token with that scope, on /mcp. |
| The tools are not there in Claude Code | Claude Code loads a new server only in a new session. | Start a new session. |
Data and safety
- The scopes of the token, or the access of a sign-in connection, decide what the agent can read and do.
- Text that the tools return from your users' sessions is data, not instructions.
- Sequential logs each successful call for the project: the tool, the connection and the time.
- Privacy Policy · Terms of Service
Registry
server.json is this server's entry for the official MCP Registry.
Links
Questions: hello@usesequential.com
License
MIT. See LICENSE.
Sequential MCP questions
How do I add Sequential MCP to Claude Code?
Run claude mcp add --transport http mcp https://api.usesequential.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Sequential MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can my agent do with Sequential?
Your agent can read cases, sessions, errors, and analytics, search sessions by description, and link pull requests or commits to specific cases.
What should I do if I get a 401 error?
A 401 error means your access token is incorrect, revoked, or expired; you should create a new token and update your configuration.