Installation

Get the Context7 MCP up and running in your favorite AI coding assistant in minutes.

Requirements

Before you begin:

MCP Client: Cursor, Claude Code, VS Code, Windsurf, or another MCP-compatible IDE
API Key (Recommended): For higher rate limits and private repositories. Get yours at context7.com/dashboard

SSE Protocol RemovedThe Server-Sent Events (SSE) transport protocol has been removed and is no longer available. Please use HTTP or stdio transport methods instead.

Quick Install

Via Smithery

Install the Context7 MCP automatically for any client via Smithery:

npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

Get your Smithery key from your account at smithery.ai.

Client-Specific Installation

Cursor

Go to: Settings → Cursor Settings → MCP → Add new global MCP serverIn Cursor 1.0 and later, use the one-click button below or manually edit ~/.cursor/mcp.json.Remote Server (Recommended):

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server:

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

Claude Code

Remote Server:

claude mcp add --transport http context7 https://mcp.context7.com/mcp \
  --header "CONTEXT7_API_KEY: YOUR_API_KEY"

Local Server:

claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

VS Code

Add to your VS Code MCP config:Remote Server:

"mcp": {
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server:

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

Windsurf

Remote Server:

{
  "mcpServers": {
    "context7": {
      "serverUrl": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server:

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

Amp

Without API Key:

amp mcp add context7 https://mcp.context7.com/mcp

With API Key:

amp mcp add context7 --header "CONTEXT7_API_KEY=YOUR_API_KEY" https://mcp.context7.com/mcp

Cline

Install through the Cline MCP Server Marketplace:

Open Cline
Click the hamburger menu (☰) → MCP Servers
Search for Context7 in the Marketplace tab
Click Install

Or manually edit the configuration:

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Zed

Install via Zed Extensions or add to settings.json:

{
  "context_servers": {
    "Context7": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Augment Code

Via UI:

Hamburger menu → Settings → Tools
Click + Add MCP
Enter command: npx -y @upstash/context7-mcp@latest
Name: Context7

Manual Configuration:

"augment.advanced": {
  "mcpServers": [
    {
      "name": "context7",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  ]
}

Roo Code

Remote Server:

{
  "mcpServers": {
    "context7": {
      "type": "streamable-http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server:

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

Gemini CLI

Open ~/.gemini/settings.json and add:Remote Server:

{
  "mcpServers": {
    "context7": {
      "httpUrl": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

Local Server:

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

Claude Desktop

Remote Server: Settings → Connectors → Add Custom Connector

Name: Context7
URL: https://mcp.context7.com/mcp

Local Server (claude_desktop_config.json):

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

Opencode

Remote Server:

"mcp": {
  "context7": {
    "type": "remote",
    "url": "https://mcp.context7.com/mcp",
    "headers": {
      "CONTEXT7_API_KEY": "YOUR_API_KEY"
    },
    "enabled": true
  }
}

Local Server:

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

OpenAI Codex

Add to your MCP server settings:

[mcp_servers.context7]
args = ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
command = "npx"

Windows: Use full paths if you encounter timeout errors:

[mcp_servers.context7]
command = "C:\\Program Files\\nodejs\\node.exe"
args = [
  "C:\\Users\\yourname\\AppData\\Roaming\\npm\\node_modules\\@upstash\\context7-mcp\\dist\\index.js",
  "--transport", "stdio", "--api-key", "YOUR_API_KEY"
]

macOS: Use full Node.js path if needed:

[mcp_servers.context7]
command = "/Users/yourname/.nvm/versions/node/v22.14.0/bin/node"
args = [
  "/Users/yourname/.nvm/versions/node/v22.14.0/lib/node_modules/@upstash/context7-mcp/dist/index.js",
  "--transport", "stdio", "--api-key", "YOUR_API_KEY"
]

JetBrains AI Assistant

Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
Click + Add
Select As JSON from the top-left dropdown
Add configuration:

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

Click Apply

Kiro

Navigate Kiro → MCP Servers
Click + Add
Add configuration:

{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Trae

Remote Server:

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

Local Server:

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

LM Studio

Or manually: Program → Install → Edit mcp.json:

{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Visual Studio 2022

Remote Server:

{
  "inputs": [],
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server:

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

Crush

Remote Server:

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server:

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

BoltAI

Open Settings → Plugins, then add:

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

Use get-library-docs in the chat with your Context7 documentation ID.

Rovo Dev CLI

Edit your config:

acli rovodev mcp

Remote Server:

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

Local Server:

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

Zencoder

Go to Zencoder menu (…)
Select Agent tools
Click Add custom MCP
Add configuration:

{
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
}

Qodo Gen

Open the Qodo Gen chat panel
Click Connect more tools
Click + Add new MCP

Local Server:

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

Remote Server:

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

Qwen Coder

See Qwen Coder MCP Configuration for details.

Open the Qwen Coder settings file. The location is ~/.qwen/settings.json (where ~ is your home directory).
Add the following to the mcpServers object in your settings.json file:

Remote Server:

{
  "mcpServers": {
    "context7": {
      "httpUrl": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

Local Server:

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

If the mcpServers object does not exist, create it.

Perplexity Desktop

Navigate to Perplexity → Settings → Connectors
Click Add Connector → Advanced
Server Name: Context7
Add configuration:

{
  "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
  "command": "npx",
  "env": {}
}

Warp

Navigate to Settings → AI → Manage MCP servers
Click + Add
Add configuration:

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

Copilot Coding Agent

Add the following to your Copilot configuration at:Repository → Settings → Copilot → Coding agent → MCP configuration

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      },
      "tools": ["get-library-docs", "resolve-library-id"]
    }
  }
}

Copilot CLI

Open the Copilot CLI MCP config file. The location is ~/.copilot/mcp-config.json (where ~ is your home directory).
Add the following to the mcpServers object in your mcp-config.json file:

Remote Server:

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      },
      "tools": [
        "get-library-docs",
        "resolve-library-id"
      ]
    }
  }
}

Local Server:

{
  "mcpServers": {
    "context7": {
      "type": "local",
      "command": "npx",
      "tools": [
        "get-library-docs",
        "resolve-library-id"
      ],
      "args": [
        "-y",
        "@upstash/context7-mcp",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

If the mcp-config.json file does not exist, create it.

Amazon Q Developer CLI

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

Windows Configuration

On Windows, configuration differs slightly. Use cmd with /c:

{
  "mcpServers": {
    "context7": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Factory

Factory’s droid supports MCP servers through its CLI. See Factory MCP docs for more info.Remote Server Connection (HTTP):Run this command in your terminal:

droid mcp add context7 https://mcp.context7.com/mcp --type http --header "CONTEXT7_API_KEY: YOUR_API_KEY"

Or without an API key (basic usage with rate limits):

droid mcp add context7 https://mcp.context7.com/mcp --type http

Local Server Connection (Stdio):Run this command in your terminal:

droid mcp add context7 "npx -y @upstash/context7-mcp" --env CONTEXT7_API_KEY=YOUR_API_KEY

Once configured, Context7 tools will be available in your droid sessions. Type /mcp within droid to manage servers, authenticate, and view available tools.

Alternative Runtimes

Using Bun

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Using Deno

{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": [
        "run",
        "--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
        "--allow-net",
        "npm:@upstash/context7-mcp"
      ]
    }
  }
}

Using Docker

Create a Dockerfile:

FROM node:18-alpine
WORKDIR /app
RUN npm install -g @upstash/context7-mcp
CMD ["context7-mcp"]

Build and configure:

docker build -t context7-mcp .

{
  "mcpServers": {
    "context7": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "context7-mcp"]
    }
  }
}

Desktop Extension

Install the context7.mcpb file. See MCP bundles docs for details.

Verify Installation

Test your setup with the MCP Inspector:

npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp

Having trouble? Check our Troubleshooting Guide for common issues and solutions.

Overview

API Reference

Resources

Requirements

Quick Install

Via Smithery

Client-Specific Installation

Alternative Runtimes

Using Bun

Using Deno

Using Docker

Desktop Extension

Verify Installation

Overview

API Reference

Resources

​Requirements

​Quick Install

​Via Smithery

​Client-Specific Installation

​Alternative Runtimes

​Using Bun

​Using Deno

​Using Docker

​Desktop Extension

​Verify Installation

Requirements

Quick Install

Via Smithery

Client-Specific Installation

Alternative Runtimes

Using Bun

Using Deno

Using Docker

Desktop Extension

Verify Installation