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)

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:

Claude Code (skills + MCP)

OpenAI Codex (skills + MCP)

Cursor (skills + MCP)

We are waiting for this plugin to be accepted to the official Cursor Marketplace. Once listed, it can be installed from Customize in the Cursor sidebar, and it brings both the skills and the MCP server. Until then, npx upstash setup --cursor installs the same plugin locally (reload the Cursor window afterwards). Gemini CLI (skills + MCP)

Gemini CLI loads this repo as an extension — the manifest is gemini-extension.json at the repo root; every skill under skills/ and the remote MCP server are picked up automatically:

OpenCode