skills

Upstash Agent Skills

Connect your AI coding agent to Upstash. This repo ships skills (per-SDK instruction packs your agent loads on demand) and the plugin manifests that install them — and now the Upstash MCP server — into Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Zed, and any Agent Skills–compatible client.

The Upstash agent surface

• Skills — packaged instructions and CLI references for each Upstash SDK (Redis, QStash, Workflow, Vector, Search, Box, Blob, Ratelimit). No credentials needed. → docs

• MCP server — live tools to query, debug, and manage your account. Two ways to run it:

  • Remote (hosted) — https://mcp.upstash.com/mcp, streamable HTTP, authenticated with OAuth (browser consent, on first use) or a developer API key header. Nothing to install.
  • Local (stdio) — @upstash/mcp-server run with npx, authenticated with your account email + a developer API key.

  → docs

• New here? Start with the AI Tools overview, and see Install by agent for full per-client setup.

What's in this repo

• skills/upstash-*/ — the per-SDK skill sources (each has a SKILL.md). Edit these.
• skills/upstash/ — the combined skill, generated from all the sources by npm run build. Never hand-edit it (see AGENTS.md).
• Plugin manifests — .claude-plugin/, .codex-plugin/, .cursor-plugin/, gemini-extension.json, and the portable Agent Plugins plugin.json + mcp.json. They make the repo installable as a plugin/extension. These plugins now bundle the remote Upstash MCP server (OAuth), so installing the plugin sets up the skills and the MCP in one step — no separate MCP configuration for Claude Code, Codex, Cursor, or Gemini CLI.
• zed-extension/ — a Zed MCP server extension (Rust → Wasm).
• assets/ — branding used on the plugin card, read by Codex (interface.logo / interface.composerIcon) and Cursor (logo). Claude Code, Gemini CLI and the Agent Plugins schema have no icon field.

Available Skills

Install

Installing through a plugin (Claude Code, Codex, Cursor, Gemini CLI) sets up both the skills and the remote MCP server — approve the MCP's OAuth consent on first use. The skills-only installers (Agent Skills CLI, OpenCode, Zed) install skills; add the MCP server separately if you want live account access, or use npx upstash, which sets up both.

For the full, up-to-date per-client instructions, see Install by agent.

One command (Claude Code, Codex, Cursor, Gemini CLI, VS Code, Copilot CLI, OpenCode)

npx upstash

Run in a terminal, the Upstash CLI detects your agents and installs the plugin where the agent supports one (Claude Code, Codex, Cursor, Gemini CLI), otherwise the remote MCP server plus the upstash skill (VS Code, Copilot CLI, OpenCode). Either way the agent gets both the skills and the MCP server, which signs in with OAuth on first use. The per-agent steps below do the same by hand.

From an agent or a script, name the agent and skip the prompts:

npx -y upstash setup --yes --claude        # or --codex, --cursor, --gemini, --vscode, --copilot, --opencode
npx -y upstash setup --yes --mode mcp      # MCP server + skill everywhere, no plugins

Claude Code (skills + MCP)

# Add the marketplace
/plugin marketplace add upstash/skills

# Install the plugin
/plugin install upstash@upstash

OpenAI Codex (skills + MCP)

# Add the marketplace
codex plugin marketplace add upstash/skills

# Install the plugin
codex plugin add upstash@upstash

Cursor (skills + MCP)

Read the full README on GitHub →