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 handPut 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/skills
codex 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 pluginPut 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"
    }
  }
}

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) serverThe 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, plus an optional upstash_box_api_key to enable Upstash Box tools.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 handPut 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/mcp
npx 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/skills
dsh 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/mcp
npx 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.

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 handPut 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/mcp
npx skills add upstash/skills --agent github-copilot

Other options

Add the MCP server by handPut 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/mcp
npx skills add upstash/skills --agent qwen-code

Other options

Add the MCP server by handPut 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 http
npx 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 handPut 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 flagsAdd --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 typeSome 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`

​Claude Code

​Claude Desktop

​Cursor

​OpenAI Codex

​OpenCode

​Zed

​GitHub Copilot

​Devin Desktop

​Gemini CLI

​Google Antigravity

​DeepSeek Harness

​Grok

​Kilo Code

​Copilot CLI

​Warp

​Qwen Code

​Hermes

​Factory

​fx

​Crush

​Any other agent

Claude Code

Claude Desktop

Cursor

OpenAI Codex

OpenCode

Zed

GitHub Copilot

Devin Desktop

Gemini CLI

Google Antigravity

DeepSeek Harness

Grok

Kilo Code

Copilot CLI

Warp

Qwen Code

Hermes

Factory

fx

Crush

Any other agent