Install by agent - Upstash Documentation

Pick your agent below. The first block in each section is the recommended setup: it connects the remote MCP server at https://mcp.upstash.com/mcp and installs the Upstash Skills. Neither needs credentials up front. The MCP server asks you to sign in over OAuth on the first tool call.

Everything else, such as editing the config file by hand or running the local (stdio) server with your email and a Developer API key, is under Other options in each section. See the MCP server page for how the remote and local servers compare.

Claude Code#

From inside Claude Code:

/plugin marketplace add upstash/skills/plugin install upstash@upstash

The plugin bundles the skills and the remote MCP server. Approve the consent screen on the first tool call.

Other options

MCP server only, without the plugin

claude mcp add --scope user --transport http upstash https://mcp.upstash.com/mcp

Then run /mcp → Authenticate.

Local (stdio) server

claude mcp add --transport stdio upstash -- npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY

See the Claude Code plugin docs and MCP docs for more info.

Claude Desktop#

Go to Customize → Plugins, click Add → Add marketplace, choose Add from a repository, and enter upstash/skills. Install the upstash plugin from that marketplace.

The plugin bundles the skills and the remote MCP server. Approve the consent screen on the first tool call.

Cursor#

Add the MCP server with one click:

Then install the skills:

npx skills add upstash/skills --agent cursor

Other options

Add the MCP server by hand

Put this in ~/.cursor/mcp.json, or in .cursor/mcp.json to scope it to one project:

{  "mcpServers": {    "upstash": { "url": "https://mcp.upstash.com/mcp" }  }}

Local (stdio) server

{  "mcpServers": {    "upstash": {      "command": "npx",      "args": ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]    }  }}

OpenAI Codex#

codex plugin marketplace add upstash/skillscodex plugin add upstash@upstash

The plugin bundles the skills and the remote MCP server. Approve the consent screen on the first tool call.

Other options

MCP server only, without the plugin

Put this in ~/.codex/config.toml, or in .codex/config.toml for one project:

[mcp_servers.upstash]url = "https://mcp.upstash.com/mcp"

Local (stdio) server

codex mcp add upstash -- npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY

See the Codex plugin docs and MCP docs for more info.

OpenCode#

Add the MCP server to opencode.json, or ~/.config/opencode/opencode.json for every project:

{  "$schema": "https://opencode.ai/config.json",  "mcp": {    "upstash": {      "type": "remote",      "url": "https://mcp.upstash.com/mcp",      "enabled": true    }  }}

Then install the skills (add --global to make them available in every project):

npx skills add upstash/skills --agent opencode

Other options

Local (stdio) server

{  "$schema": "https://opencode.ai/config.json",  "mcp": {    "upstash": {      "type": "local",      "command": ["npx", "-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"],      "enabled": true    }  }}

See the OpenCode skills and MCP docs for more info.

Zed#

Add the MCP server to settings.json, or through Settings → AI → MCP Servers → Add Server → Add Remote Server:

{  "context_servers": {    "upstash": {      "url": "https://mcp.upstash.com/mcp"    }  }}

Note

Context servers are project-scoped in Zed. Open a folder before testing, otherwise the server never starts.

Then install the skills (add --global to make them available in every project):

npx skills add upstash/skills --agent zed

Other options

Local (stdio) server

The repo ships a Zed extension in zed-extension/. Clone the repo, run zed: install dev extension from the command palette, and pick the zed-extension/ directory. Zed then prompts for upstash_email and upstash_api_key.

See the Zed skills and MCP docs for more info.

GitHub Copilot#

Add the MCP server to VS Code with one click:

Then install the skills:

npx skills add upstash/skills --agent github-copilot

Other options

Add the MCP server by hand

Put this in .vscode/mcp.json:

{  "servers": {    "upstash": {      "type": "http",      "url": "https://mcp.upstash.com/mcp"    }  }}

Local (stdio) server

{  "servers": {    "upstash": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]    }  }}

See the VS Code MCP docs for more info.

Devin Desktop#

Devin Desktop is the new name for Windsurf and keeps its settings. Add the MCP server to ~/.codeium/windsurf/mcp_config.json:

{  "mcpServers": {    "upstash": {      "serverUrl": "https://mcp.upstash.com/mcp"    }  }}

Then install the skills:

npx skills add upstash/skills --agent windsurf

Other options

Local (stdio) server

{  "mcpServers": {    "upstash": {      "command": "npx",      "args": ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]    }  }}

See the Devin Desktop migration notes for more info.

Gemini CLI#

gemini extensions install https://github.com/upstash/skills

The extension bundles the skills and the remote MCP server. Approve the consent screen on the first tool call.

Other options

MCP server and skills separately

gemini mcp add --transport http upstash https://mcp.upstash.com/mcpnpx skills add upstash/skills --agent gemini-cli

Or add the server to ~/.gemini/settings.json by hand:

{  "mcpServers": {    "upstash": {      "httpUrl": "https://mcp.upstash.com/mcp"    }  }}

Local (stdio) server

{  "mcpServers": {    "upstash": {      "command": "npx",      "args": ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]    }  }}

See the Gemini CLI extension and MCP docs for more info.

Google Antigravity#

Add the MCP server to your Antigravity MCP config. Antigravity registers itself as an OAuth client, so no credentials go in the file:

{  "mcpServers": {    "upstash": {      "serverUrl": "https://mcp.upstash.com/mcp"    }  }}

Then install the skills:

npx skills add upstash/skills --agent antigravity

Other options

Local (stdio) server

{  "mcpServers": {    "upstash": {      "command": "npx",      "args": ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]    }  }}

See the Antigravity MCP docs for more info.

DeepSeek Harness#

Requires pnpm on your PATH. Install the bundle into a profile (web is the one dsh web boots) and start the harness:

dsh plugin --profile web add github:upstash/skillsdsh web

The bundle loads the skills right away. It also mounts the local (stdio) MCP server, which starts once you store your credentials from inside a session:

/upstash-login YOUR_EMAIL YOUR_API_KEY

Credentials are saved to ~/.dsh/.credentials.yaml. The server restarts whenever they change.

Grok#

grok mcp add --transport http upstash https://mcp.upstash.com/mcpnpx skills add upstash/skills --agent grok

Pass --scope project to grok mcp add to write the server to .grok/config.toml in the current directory. Run grok mcp doctor upstash to check the connection.

Note

Grok Build also reads Claude Code plugins, so if you already installed the Claude Code plugin, the skills are available without the second command.

Other options

Add the MCP server by hand

Put this in ~/.grok/config.toml:

[mcp_servers.upstash]url = "https://mcp.upstash.com/mcp"

Local (stdio) server

[mcp_servers.upstash]command = "npx"args = ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]

See the Grok Build MCP docs for more info.

Kilo Code#

Add the MCP server to kilo.jsonc in the project root, or ~/.config/kilo/kilo.jsonc for every project:

{  "mcp": {    "upstash": {      "type": "remote",      "url": "https://mcp.upstash.com/mcp",      "enabled": true    }  }}

Then install the skills:

npx skills add upstash/skills --agent kilo

Other options

Local (stdio) server

{  "mcp": {    "upstash": {      "type": "local",      "command": ["npx", "-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"],      "enabled": true    }  }}

Copilot CLI#

copilot mcp add --transport http upstash https://mcp.upstash.com/mcpnpx skills add upstash/skills --agent github-copilot

Other options

Add the MCP server by hand

Put this in ~/.copilot/mcp-config.json:

{  "mcpServers": {    "upstash": {      "type": "http",      "url": "https://mcp.upstash.com/mcp"    }  }}

Local (stdio) server

{  "mcpServers": {    "upstash": {      "type": "local",      "command": "npx",      "args": ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]    }  }}

Warp#

Go to Settings → Agents → MCP servers → + Add and paste:

{  "upstash": {    "url": "https://mcp.upstash.com/mcp",    "start_on_launch": true  }}

Then install the skills:

npx skills add upstash/skills --agent warp

Other options

Local (stdio) server

{  "upstash": {    "command": "npx",    "args": ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"],    "env": {},    "working_directory": null,    "start_on_launch": true  }}

Qwen Code#

qwen mcp add --transport http upstash https://mcp.upstash.com/mcpnpx skills add upstash/skills --agent qwen-code

Other options

Add the MCP server by hand

Put this in ~/.qwen/settings.json, or .qwen/settings.json for one project:

{  "mcpServers": {    "upstash": {      "httpUrl": "https://mcp.upstash.com/mcp"    }  }}

Local (stdio) server

qwen mcp add upstash -- npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY

Hermes#

Add the MCP server to ~/.hermes/config.yaml:

mcp_servers:  upstash:    url: "https://mcp.upstash.com/mcp"

Then install the skills:

npx skills add upstash/skills --agent hermes-agent

Other options

Local (stdio) server

mcp_servers:  upstash:    command: "npx"    args: ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]

Factory#

droid mcp add upstash https://mcp.upstash.com/mcp --type httpnpx skills add upstash/skills --agent droid

Other options

Local (stdio) server

droid mcp add upstash "npx -y @upstash/mcp-server@latest --email YOUR_EMAIL --api-key YOUR_API_KEY"

fx#

From inside an fx session:

/mcp add --transport http upstash https://mcp.upstash.com/mcp/skills install upstash/skills --skill upstash

Other options

Add the MCP server by hand

Put this in ~/.fx/mcp.json:

{  "mcp": {    "upstash": {      "type": "http",      "url": "https://mcp.upstash.com/mcp"    }  }}

Local (stdio) server

{  "mcp": {    "upstash": {      "type": "stdio",      "command": ["npx", "-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]    }  }}

See the fx MCP docs for more info.

Crush#

Add the MCP server to your Crush config file:

{  "$schema": "https://charm.land/crush.json",  "mcp": {    "upstash": {      "type": "http",      "url": "https://mcp.upstash.com/mcp"    }  }}

Then install the skills:

npx skills add upstash/skills --agent crush

Other options

Local (stdio) server

{  "$schema": "https://charm.land/crush.json",  "mcp": {    "upstash": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]    }  }}

Any other agent#

Add the MCP server to your client's config. Most clients take this shape:

{  "mcpServers": {    "upstash": {      "url": "https://mcp.upstash.com/mcp"    }  }}

Then install the skills. The Agent Skills CLI supports 70+ agents and detects the ones on your machine:

npx skills add upstash/skills

Other options

Skills CLI flags

Add --global (-g) to install for every project, --agent (-a) to target one agent, and --skill (-s) to install a single SDK skill, for example --skill upstash-qstash-js.

Transport type

Some clients want the transport named next to the URL: "type": "http" for most, "type": "streamable-http" for Roo Code, "type": "remote" for OpenCode and Kilo Code. Unrecognized keys are usually ignored, so start with the plain url.

Local (stdio) server

{  "mcpServers": {    "upstash": {      "command": "npx",      "args": ["-y", "@upstash/mcp-server@latest", "--email", "YOUR_EMAIL", "--api-key", "YOUR_API_KEY"]    }  }}

Where some other clients take it, with their Agent Skills CLI id:

Client	Skills `id`	MCP server
Amp	`amp`	`amp mcp add upstash https://mcp.upstash.com/mcp`
Kiro	`kiro-cli`	`.kiro/settings/mcp.json`, or Kiro → MCP Servers → + Add; takes `url`
Cline	`cline`	MCP Servers → Remote Servers → Edit Configuration; takes `url`
Roo Code	`roo`	MCP settings file (`mcp_settings.json`); needs `"type": "streamable-http"`
Trae	`trae`	MCP → Add manually; takes `url`
Augment Code	`augment`	Settings → MCP → + Add remote MCP, connection type HTTP
Zencoder	`zencoder`	Agent tools → Add custom MCP, paste the `upstash` entry
Rovo Dev CLI	`rovodev`	`acli rovodev mcp` opens the config file; takes `url`