Skip to content

Context7 Platform -- Up-to-date docs for AI agents

docs: add dedicated Cursor and Claude Code client guides with plugin marketplace (#1385)

Fahreddin Özcanb41e7c84824b
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 00000000..d6335687
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,14 @@
+{
+ "name": "context7-marketplace",
+ "owner": {
+ "name": "Upstash"
+ },
+ "plugins": [
+ {
+ "name": "context7-plugin",
+ "source": "./plugins/claude/context7",
+ "description": "Up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.",
+ "version": "1.0.0"
+ }
+ ]
+}
diff --git a/.prettierignore b/.prettierignore
index 8c9f2f25..7fd6ada4 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -26,3 +26,6 @@ out
# Changesets
.changeset/*.md
+
+# Documentation
+docs
diff --git a/docs/clients/claude-code.mdx b/docs/clients/claude-code.mdx
new file mode 100644
index 00000000..e2a9671d
--- /dev/null
+++ b/docs/clients/claude-code.mdx
@@ -0,0 +1,230 @@
+---
+title: Claude Code
+description: Using Context7 with Claude Code
+---
+
+Context7 integrates with Claude Code to provide current library documentation instead of relying on training data. Beyond the basic MCP connection, Claude Code supports skills, agents, and commands that make documentation lookups more powerful.
+
+<Tip>
+Context7 works without an API key for basic usage. Adding an API key gives you higher rate limits, access to private repositories, and team usage tracking. Get one at [context7.com/dashboard](https://context7.com/dashboard).
+</Tip>
+
+## Installation
+
+<Tabs>
+<Tab title="Remote Server (Recommended)" icon="cloud">
+No dependencies required. Connects to Context7's hosted server.
+
+<CodeGroup>
+```bash With OAuth (Recommended)
+claude mcp add --transport http context7 https://mcp.context7.com/mcp/oauth
+```
+
+```bash With API Key
+claude mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: YOUR_API_KEY"
+```
+
+```bash Without API Key
+claude mcp add --transport http context7 https://mcp.context7.com/mcp
+```
+</CodeGroup>
+
+<Tip>
+Using OAuth? You'll be redirected to sign in the first time you connect. After that, tokens refresh automatically. See [OAuth authentication](/howto/oauth) for details.
+</Tip>
+</Tab>
+<Tab title="Local Server" icon="computer">
+Runs on your machine. Requires Node.js 18+.
+
+<CodeGroup>
+```bash With API Key
+claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY
+```
+
+```bash Without API Key
+claude mcp add context7 -- npx -y @upstash/context7-mcp
+```
+</CodeGroup>
+
+**Using environment variables:**
+
+Instead of passing the API key in the command, you can set it as an environment variable:
+
+```bash
+export CONTEXT7_API_KEY=your_api_key_here
+claude mcp add context7 -- npx -y @upstash/context7-mcp
+```
+</Tab>
+</Tabs>
+
+### Verifying the Connection
+
+Run `/mcp` in Claude Code to see all servers and manage authentication:
+
+<Frame>
+ <img src="/images/clients/claude-code/mcp-list.png" alt="Claude Code MCP List" />
+</Frame>
+
+Select a server to see details including status, authentication, and available tools:
+
+<Frame>
+ <img src="/images/clients/claude-code/mcp-details.png" alt="Claude Code MCP Details" />
+</Frame>
+
+You can also run `claude mcp list` in your terminal:
+
+```bash
+$ claude mcp list
+Checking MCP server health...
+
+context7: https://mcp.context7.com/mcp (HTTP) - ✓ Connected
+```
+
+---
+
+## Using Context7
+
+Add "use context7" to your prompts to fetch current documentation:
+
+```
+use context7 to show me how to set up middleware in Next.js 15
+use context7 for Prisma query examples with relations
+use context7 for the Supabase syntax for row-level security
+```
+
+If you know the library ID, use it directly to skip resolution:
+
+```
+use context7 with /supabase/supabase for authentication docs
+use context7 with /vercel/next.js for app router setup
+```
+
+<Tip>
+With the [Context7 plugin](#the-context7-plugin) installed, the skill triggers automatically — no need to say "use context7".
+</Tip>
+
+---
+
+## The Context7 Plugin
+
+The full Context7 plugin for Claude Code includes more than just the MCP server:
+
+<CardGroup cols={2}>
+<Card title="MCP Server" icon="server">
+The tools for fetching documentation (`resolve-library-id`, `query-docs`)
+</Card>
+<Card title="Skills" icon="sparkles">
+Auto-triggers documentation lookups when you ask about libraries
+</Card>
+<Card title="Agents" icon="robot">
+A `docs-researcher` agent for focused lookups that keep context lean
+</Card>
+<Card title="Commands" icon="terminal">
+`/context7:docs` for manual documentation queries
+</Card>
+</CardGroup>
+
+### Installing the Plugin
+
+The plugin is available from the Context7 marketplace. Run these commands in Claude Code:
+
+```
+/plugin marketplace add upstash/context7
+/plugin install context7-plugin@context7-marketplace
+```
+
+This adds the Context7 marketplace and installs the plugin with skills, agents, and commands.
+
+### Skills
+
+#### Documentation Lookup Skill
+
+This skill triggers automatically when you ask about libraries, frameworks, or need code examples. You don't need to type "use context7" — the skill recognizes when documentation would help.
+
+<AccordionGroup>
+<Accordion title="What triggers the skill">
+- Setup questions: "How do I configure Next.js middleware?"
+- Code generation: "Write a Prisma query for user relations"
+- API references: "What are the Supabase auth methods?"
+- Framework mentions: React, Vue, Svelte, Express, Tailwind, etc.
+</Accordion>
+<Accordion title="How it works">
+1. **Resolve**: Finds the library ID using `resolve-library-id` with your question as context
+2. **Select**: Picks the best match based on name accuracy and quality scores
+3. **Fetch**: Calls `query-docs` with the library ID and your specific question
+4. **Return**: Provides code examples and explanations from current documentation
+</Accordion>
+<Accordion title="Limits">
+- Maximum 3 documentation calls per question
+- Uses version-specific IDs when you mention versions
+</Accordion>
+</AccordionGroup>
+
+### Agents
+
+#### docs-researcher Agent
+
+When you're in the middle of a long task and don't want documentation tool calls cluttering your context, spawn the `docs-researcher` agent. It runs in a separate context and returns just the answer.
+
+<Tabs>
+<Tab title="When to Use" icon="question">
+- You need docs but want to keep your main context clean
+- You're working on something complex and context is getting long
+- You want a focused answer without side effects
+</Tab>
+<Tab title="Examples" icon="code">
+```
+spawn docs-researcher to look up React hooks documentation
+spawn docs-researcher: how do I set up Prisma with PostgreSQL?
+spawn docs-researcher to find Tailwind CSS grid utilities
+```
+</Tab>
+</Tabs>
+
+The agent uses the same tools (`resolve-library-id` and `query-docs`) but runs on a lighter model (Sonnet) to keep things fast.
+
+#### When to Use Agents vs Inline Tools
+
+| Scenario | Use |
+|----------|-----|
+| Deep into a task with long context | Agent |
+| Want to avoid context bloat | Agent |
+| Context is short | Inline tools |
+| Want docs visible in conversation | Inline tools |
+
+### Commands
+
+#### /context7:docs
+
+Manual command for documentation lookups.
+
+**Format:**
+```
+/context7:docs <library> [query]
+```
+
+**Examples:**
+
+<Tabs>
+<Tab title="Basic" icon="search">
+```
+/context7:docs react hooks
+/context7:docs next.js authentication
+/context7:docs prisma relations
+```
+</Tab>
+<Tab title="With Library ID" icon="link">
+```
+/context7:docs /vercel/next.js app router
+/context7:docs /supabase/supabase row level security
+```
+
+Using a library ID directly skips the resolution step.
+</Tab>
+</Tabs>
+
+**When to use:**
+- You know exactly which library and topic you need
+- You want a quick lookup without explaining your full context
+- You're testing what documentation is available
+
diff --git a/docs/clients/cursor.mdx b/docs/clients/cursor.mdx
new file mode 100644
index 00000000..d0dea4b6
--- /dev/null
+++ b/docs/clients/cursor.mdx
@@ -0,0 +1,319 @@
+---
+title: Cursor
+description: Using Context7 with Cursor
+---
+
+export const InstallOption = ({ title, children, recommended }) => {
+ return (
+ <div className="p-5 rounded-xl border border-zinc-200 dark:border-zinc-700 bg-zinc-50/50 dark:bg-zinc-800/50">
+ <div className="flex items-center gap-2 mb-3">
+ <span className="font-semibold text-zinc-900 dark:text-zinc-100">{title}</span>
+ {recommended && (
+ <span className="px-2 py-0.5 text-xs font-medium rounded-full bg-emerald-100 dark:bg-emerald-900/30 text-emerald-700 dark:text-emerald-400">
+ Recommended
+ </span>
+ )}
+ </div>
+ <div className="text-zinc-600 dark:text-zinc-400">{children}</div>
+ </div>
+ );
+};
+
+export const CursorInstallButton = ({ url, type = "remote" }) => {
+ return (
+ <a
+ href={url}
+ target="_blank"
+ rel="noopener noreferrer"
+ className="group inline-flex items-center gap-3 px-5 py-3 rounded-xl border-2 border-zinc-900 dark:border-zinc-100 bg-zinc-900 dark:bg-zinc-100 hover:bg-zinc-800 dark:hover:bg-zinc-200 transition-all duration-200 no-underline w-fit"
+ >
+ <svg
+ xmlns="http://www.w3.org/2000/svg"
+ viewBox="0 0 21 22"
+ className="w-6 h-6 text-white dark:text-zinc-900"
+ fill="currentColor"
+ >
+ <path d="M19.162 5.452 10.698.565a.88.88 0 0 0-.879 0L1.356 5.452a.74.74 0 0 0-.37.64v9.853a.74.74 0 0 0 .37.64l8.464 4.887a.879.879 0 0 0 .879 0l8.464-4.886a.74.74 0 0 0 .37-.64V6.091a.74.74 0 0 0-.37-.64Zm-.531 1.035L10.46 20.639c-.055.095-.201.056-.201-.055v-9.266a.52.52 0 0 0-.26-.45L1.975 6.237c-.096-.056-.057-.202.054-.202h16.34c.233 0 .378.252.262.453Z" />
+ </svg>
+ <span className="text-sm font-semibold text-white dark:text-zinc-900">
+ Add to Cursor
+ </span>
+ <svg
+ className="w-4 h-4 text-white/70 dark:text-zinc-900/70 group-hover:translate-x-0.5 transition-transform"
+ fill="none"
+ viewBox="0 0 24 24"
+ stroke="currentColor"
+ strokeWidth={2}
+ >
+ <path strokeLinecap="round" strokeLinejoin="round" d="M9 5l7 7-7 7" />
+ </svg>
+ </a>
+ );
+};
+
+export const Divider = ({ text }) => {
+ return (
+ <div className="flex items-center gap-4 my-6">
+ <div className="flex-1 h-px bg-zinc-200 dark:bg-zinc-700" />
+ <span className="text-sm text-zinc-500 dark:text-zinc-400 font-medium">{text}</span>
+ <div className="flex-1 h-px bg-zinc-200 dark:bg-zinc-700" />
+ </div>
+ );
+};
+
+Context7 brings up-to-date library documentation directly into Cursor. Instead of getting outdated code examples from training data, you get current documentation from source repositories.
+
+<Tip>
+ Context7 works without an API key for basic usage. Adding an API key gives you higher rate limits,
+ access to private repositories, and team usage tracking. Get one at
+ [context7.com/dashboard](https://context7.com/dashboard).
+</Tip>
+
+## Installation
+
+<Tabs>
+<Tab title="Remote Server (Recommended)" icon="cloud">
+No dependencies required. Connects to Context7's hosted server.
+
+<InstallOption title="One-Click Install" recommended>
+Click the button to add Context7 to Cursor automatically:
+
+<div className="mt-3">
+<CursorInstallButton url="https://cursor.com/en/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIiwiaGVhZGVycyI6eyJDT05URVhUN19BUElfS0VZIjoiWU9VUl9BUElfS0VZIn19" type="remote" />
+</div>
+</InstallOption>
+
+<Divider text="or" />
+
+<InstallOption title="Manual Installation">
+<Steps>
+<Step title="Open Cursor Settings">
+Go to `Cursor` → `Settings...` → `Cursor Settings` → `MCP`.
+
+You can also press `Cmd+Shift+P` (or `Ctrl+Shift+P` on Windows/Linux) and type "Cursor Settings".
+
+<Frame>
+ <img src="/images/clients/cursor/mcp-settings.png" alt="Cursor MCP Settings" />
+</Frame>
+</Step>
+<Step title="Add Context7 Server">
+Click "Add a Custom MCP Server" or edit `~/.cursor/mcp.json` directly:
+
+<CodeGroup>
+```json With API Key
+{
+ "mcpServers": {
+ "context7": {
+ "url": "https://mcp.context7.com/mcp",
+ "headers": {
+ "CONTEXT7_API_KEY": "YOUR_API_KEY"
+ }
+ }
+ }
+}
+```
+
+```json With OAuth
+{
+ "mcpServers": {
+ "context7": {
+ "url": "https://mcp.context7.com/mcp/oauth"
+ }
+ }
+}
+```
+
+```json Without API Key
+{
+ "mcpServers": {
+ "context7": {
+ "url": "https://mcp.context7.com/mcp"
+ }
+ }
+}
+```
+</CodeGroup>
+
+<Tip>
+Using OAuth? You'll be redirected to sign in the first time you connect. After that, tokens refresh automatically. See [OAuth authentication](/howto/oauth) for details.
+</Tip>
+</Step>
+</Steps>
+</InstallOption>
+</Tab>
+<Tab title="Local Server" icon="computer">
+Runs on your machine. Requires Node.js 18+.
+
+<InstallOption title="One-Click Install" recommended>
+Click the button to add Context7 to Cursor automatically:
+
+<div className="mt-3">
+<CursorInstallButton
+ url="https://cursor.com/en/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB1cHN0YXNoL2NvbnRleHQ3LW1jcCIsIi0tYXBpLWtleSIsIllPVVJfQVBJX0tFWSJdfQ=="
+ type="local"
+/>
+</div>
+</InstallOption>
+
+<Divider text="or" />
+
+<InstallOption title="Manual Installation">
+<Steps>
+<Step title="Open Cursor Settings">
+Go to `Cursor` → `Settings...` → `Cursor Settings` → `MCP`.
+
+You can also press `Cmd+Shift+P` (or `Ctrl+Shift+P` on Windows/Linux) and type "Cursor Settings".
+
+<Frame>
+ <img src="/images/clients/cursor/mcp-settings.png" alt="Cursor MCP Settings" />
+</Frame>
+</Step>
+<Step title="Add Context7 Server">
+Click "Add a Custom MCP Server" or edit `~/.cursor/mcp.json` directly:
+
+<CodeGroup>
+```json With API Key
+{
+ "mcpServers": {
+ "context7": {
+ "command": "npx",
+ "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
+ }
+ }
+}
+```
+
+```json Without API Key
+{
+ "mcpServers": {
+ "context7": {
+ "command": "npx",
+ "args": ["-y", "@upstash/context7-mcp"]
+ }
+ }
+}
+```
+
+</CodeGroup>
+</Step>
+</Steps>
+</InstallOption>
+</Tab>
+</Tabs>
+
+### Project-Level Configuration
+
+You can also configure Context7 for a specific project by creating `.cursor/mcp.json` in your project folder. This is useful when:
+
+- Different projects need different API keys
+- You want to share the config with your team via version control
+- A project requires specific Context7 settings
+
+The project config uses the same format as the global config.
+
+---
+
+## Setting Up Rules
+
+To make Context7 trigger automatically (without typing "use context7" every time), add a rule in Cursor.
+
+<Tabs>
+<Tab title="Cursor Settings" icon="settings">
+<Steps>
+<Step title="Open Settings">
+Go to `Cursor` → `Settings...` → `Cursor Settings` → `Rules and Commands`. You can also press `Cmd+Shift+P` (or `Ctrl+Shift+P` on Windows/Linux) and type "Cursor Settings".
+
+<Frame>
+ <img src="/images/clients/cursor/rules.png" alt="Cursor Rules and Commands" />
+</Frame>
+</Step>
+<Step title="Add the Rule">
+```
+Always use Context7 MCP when I ask about library documentation,
+API references, or need code examples from external packages.
+```
+</Step>
+</Steps>
+</Tab>
+<Tab title=".cursorrules File" icon="file">
+Create a `.cursorrules` file in your project root:
+
+```
+# Context7 Integration
+
+When the user asks about:
+- Library APIs or documentation
+- Framework setup or configuration
+- Code examples for external packages
+- How to use a specific library feature
+
+Automatically use Context7 MCP to fetch current documentation. Don't rely on training data for library-specific code.
+```
+
+This makes Context7 part of your project's standard workflow and can be version-controlled.
+
+</Tab>
+</Tabs>
+
+---
+
+## Using Context7
+
+Add "use context7" to your prompts to fetch current documentation:
+
+```
+use context7 to show me how to set up middleware in Next.js 15
+use context7 for Prisma query examples with relations
+use context7 for the Supabase syntax for row-level security
+```
+
+If you know the library ID, use it directly to skip resolution:
+
+```
+use context7 with /supabase/supabase for authentication docs
+use context7 with /vercel/next.js for app router setup
+```
+
+---
+
+## Tips
+
+<AccordionGroup>
+<Accordion title="Project vs Global Config">
+Use **global config** (`~/.cursor/mcp.json`) when:
+- You want Context7 available in all projects
+- You're using a personal API key
+
+Use **project config** (`.cursor/mcp.json`) when:
+
+- The project has specific Context7 requirements
+- You want to share the setup with teammates
+- Different projects need different API keys
+</Accordion>
+
+<Accordion title="Combining with Cursor Composer">
+Context7 works well with Cursor's Composer feature. When you're building something that involves external libraries:
+
+1. Start with a prompt that mentions the libraries you need
+2. Context7 fetches the relevant docs
+3. Composer uses those docs to generate accurate code
+
+This is especially useful for newer library versions that might not be in Cursor's training data.
+
+</Accordion>
+
+<Accordion title="Getting Better Results">
+- Be specific about what you're trying to do, not just which library
+- Mention versions when they matter
+- If the first result isn't right, ask for a different part of the docs
+
+```
+# Good
+How do I handle file uploads with the Supabase Storage API?
+
+# Less specific
+How does Supabase storage work?
+```
+
+</Accordion>
+</AccordionGroup>
diff --git a/docs/docs.json b/docs/docs.json
index 5e323a0f..b8863836 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -37,6 +37,10 @@
"howto/usage"
]
},
+ {
+ "group": "Clients",
+ "pages": ["clients/cursor", "clients/claude-code"]
+ },
{
"group": "SDKs",
"pages": [
diff --git a/docs/howto/oauth.mdx b/docs/howto/oauth.mdx
index cb15478f..18fa17fb 100644
--- a/docs/howto/oauth.mdx
+++ b/docs/howto/oauth.mdx
@@ -34,6 +34,10 @@ To use OAuth, change the endpoint from `/mcp` to `/mcp/oauth` in your client con
3. After signing in, you're redirected back to your client
4. Your client automatically handles token refresh
+<Warning>
+**Authentication required after setup.** Most clients won't authenticate automatically. After adding the OAuth endpoint, you'll need to explicitly authenticate through your client's MCP settings. For example, in Claude Code run `/mcp`, select the server, and choose "Authenticate".
+</Warning>
+
## Client Support
OAuth authentication requires your MCP client to support the [MCP OAuth specification](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). If your client doesn't support OAuth, use [API key authentication](/howto/api-keys) instead.
diff --git a/docs/images/clients/claude-code/mcp-details.png b/docs/images/clients/claude-code/mcp-details.png
new file mode 100644
index 00000000..26017fd3
Binary files /dev/null and b/docs/images/clients/claude-code/mcp-details.png differ
diff --git a/docs/images/clients/claude-code/mcp-list.png b/docs/images/clients/claude-code/mcp-list.png
new file mode 100644
index 00000000..49b23cba
Binary files /dev/null and b/docs/images/clients/claude-code/mcp-list.png differ
diff --git a/docs/images/clients/cursor/logo.png b/docs/images/clients/cursor/logo.png
new file mode 100644
index 00000000..690b4c3d
Binary files /dev/null and b/docs/images/clients/cursor/logo.png differ
diff --git a/docs/images/clients/cursor/mcp-settings.png b/docs/images/clients/cursor/mcp-settings.png
new file mode 100644
index 00000000..30cad4ff
Binary files /dev/null and b/docs/images/clients/cursor/mcp-settings.png differ
diff --git a/docs/images/clients/cursor/rules.png b/docs/images/clients/cursor/rules.png
new file mode 100644
index 00000000..ec975fdd
Binary files /dev/null and b/docs/images/clients/cursor/rules.png differ
diff --git a/docs/resources/all-clients.mdx b/docs/resources/all-clients.mdx
index 0b333517..dbe0c8c1 100644
--- a/docs/resources/all-clients.mdx
+++ b/docs/resources/all-clients.mdx
@@ -5,6 +5,12 @@ description: Installation examples for MCP clients
Context7 supports all MCP clients. Below are configuration examples for popular clients. If your client isn't listed, check its documentation for MCP server installation.
+<Note>
+For detailed guides including rules, skills, agents, and best practices, see the dedicated client pages:
+- [Cursor](/clients/cursor) - Rules setup, Composer integration, tips
+- [Claude Code](/clients/claude-code) - Skills, agents, commands, plugin installation
+</Note>
+
<AccordionGroup>
<Accordion title="Claude Code">
diff --git a/plugins/claude/context7/.claude-plugin/plugin.json b/plugins/claude/context7/.claude-plugin/plugin.json
new file mode 100644
index 00000000..a53438cb
--- /dev/null
+++ b/plugins/claude/context7/.claude-plugin/plugin.json
@@ -0,0 +1,7 @@
+{
+ "name": "context7",
+ "description": "Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.",
+ "author": {
+ "name": "Upstash"
+ }
+}
diff --git a/plugins/claude/context7/.mcp.json b/plugins/claude/context7/.mcp.json
new file mode 100644
index 00000000..989effd5
--- /dev/null
+++ b/plugins/claude/context7/.mcp.json
@@ -0,0 +1,6 @@
+{
+ "context7": {
+ "type": "http",
+ "url": "https://mcp.context7.com/mcp"
+ }
+}
diff --git a/plugins/claude/context7/README.md b/plugins/claude/context7/README.md
new file mode 100644
index 00000000..a54ea164
--- /dev/null
+++ b/plugins/claude/context7/README.md
@@ -0,0 +1,72 @@
+# Context7 Plugin for Claude Code
+
+Context7 solves a common problem with AI coding assistants: outdated training data and hallucinated APIs. Instead of relying on stale knowledge, Context7 fetches current documentation directly from source repositories.
+
+## What's Included
+
+This plugin provides:
+
+- **MCP Server** - Connects Claude Code to Context7's documentation service
+- **Skills** - Auto-triggers documentation lookups when you ask about libraries
+- **Agents** - A dedicated `docs-researcher` agent for focused lookups
+- **Commands** - `/context7:docs` for manual documentation queries
+
+## Installation
+
+Copy this plugin folder to your Claude Code plugins directory, or run:
+
+```bash
+claude plugins install context7
+```
+
+## Available Tools
+
+### resolve-library-id
+
+Searches for libraries and returns Context7-compatible identifiers.
+
+```
+Input: "next.js"
+Output: { id: "/vercel/next.js", name: "Next.js", versions: ["v15.1.8", "v14.2.0", ...] }
+```
+
+### query-docs
+
+Fetches documentation for a specific library, ranked by relevance to your question.
+
+```
+Input: { libraryId: "/vercel/next.js", query: "app router middleware" }
+Output: Relevant documentation snippets with code examples
+```
+
+## Usage Examples
+
+The plugin works automatically when you ask about libraries:
+
+- "How do I set up authentication in Next.js 15?"
+- "Show me React Server Components examples"
+- "What's the Prisma syntax for relations?"
+
+For manual lookups, use the command:
+
+```
+/context7:docs next.js app router
+/context7:docs /vercel/next.js/v15.1.8 middleware
+```
+
+Or spawn the docs-researcher agent when you want to keep your main context clean:
+
+```
+spawn docs-researcher to look up Supabase auth methods
+```
+
+## Version Pinning
+
+To get documentation for a specific version, include the version in the library ID:
+
+```
+/vercel/next.js/v15.1.8
+/supabase/supabase/v2.45.0
+```
+
+The `resolve-library-id` tool returns available versions, so you can pick the one that matches your project.
diff --git a/plugins/claude/context7/agents/docs-researcher.md b/plugins/claude/context7/agents/docs-researcher.md
new file mode 100644
index 00000000..2682c02e
--- /dev/null
+++ b/plugins/claude/context7/agents/docs-researcher.md
@@ -0,0 +1,42 @@
+---
+description: Lightweight agent for fetching library documentation without cluttering your main conversation context.
+tools:
+ - resolve-library-id
+ - query-docs
+model: sonnet
+---
+
+# Documentation Researcher
+
+This agent handles library and framework documentation lookups in a separate context, keeping your main conversation lean.
+
+## When to Use
+
+Spawn this agent when:
+
+- You need documentation for a library but don't want tool call results in your main context
+- You're asking "how do I..." or "what's the API for..." questions
+- You want focused answers with code examples
+- You're working on a long task and want to avoid context bloat
+
+## How It Works
+
+1. Takes your question about a library or framework
+2. Resolves the library name to a Context7 ID using `resolve-library-id`
+3. Picks the best match based on name accuracy and benchmark scores
+4. Fetches relevant documentation with `query-docs`
+5. Returns a concise answer with code examples
+
+## Examples
+
+```
+spawn docs-researcher to look up React hooks documentation
+spawn docs-researcher: how do I set up Prisma with PostgreSQL?
+spawn docs-researcher to find Tailwind CSS grid utilities
+```
+
+## Limits
+
+- Maximum 3 `query-docs` calls per question
+- Uses version-specific IDs when you mention a version (e.g., "Next.js 15")
+- Passes your full question to the query for better relevance ranking
diff --git a/plugins/claude/context7/commands/docs.md b/plugins/claude/context7/commands/docs.md
new file mode 100644
index 00000000..a4cefa3a
--- /dev/null
+++ b/plugins/claude/context7/commands/docs.md
@@ -0,0 +1,44 @@
+---
+description: Look up documentation for any library
+---
+
+# /context7:docs
+
+Fetches up-to-date documentation and code examples for a library.
+
+## Usage
+
+```
+/context7:docs <library> [query]
+```
+
+- **library**: The library name, or a Context7 ID starting with `/`
+- **query**: What you're looking for (optional but recommended)
+
+## Examples
+
+```
+/context7:docs react hooks
+/context7:docs next.js authentication
+/context7:docs prisma relations
+/context7:docs /vercel/next.js/v15.1.8 app router
+/context7:docs /supabase/supabase row level security
+```
+
+## How It Works
+
+1. If the library starts with `/`, it's used directly as the Context7 ID
+2. Otherwise, `resolve-library-id` finds the best matching library
+3. `query-docs` fetches documentation relevant to your query
+4. Results include code examples and explanations
+
+## Version-Specific Lookups
+
+Include the version in the library ID for pinned documentation:
+
+```
+/context7:docs /vercel/next.js/v15.1.8 middleware
+/context7:docs /facebook/react/v19.0.0 use hook
+```
+
+This is useful when you're working with a specific version and want docs that match exactly.
diff --git a/plugins/claude/context7/skills/documentation-lookup/SKILL.md b/plugins/claude/context7/skills/documentation-lookup/SKILL.md
new file mode 100644
index 00000000..e40db8d0
--- /dev/null
+++ b/plugins/claude/context7/skills/documentation-lookup/SKILL.md
@@ -0,0 +1,61 @@
+---
+description: Automatically fetches library documentation when you ask about frameworks, APIs, or code patterns.
+triggers:
+ - library questions
+ - framework setup
+ - API references
+ - code examples
+---
+
+# Documentation Lookup
+
+This skill activates when you ask questions about libraries, frameworks, or need code examples. It fetches current documentation from source repositories instead of relying on training data.
+
+## When It Triggers
+
+The skill runs automatically when you:
+
+- Ask setup questions ("How do I configure Next.js middleware?")
+- Request code generation involving libraries ("Write a Prisma query for...")
+- Need API references ("What are the Supabase auth methods?")
+- Mention specific frameworks (React, Vue, Svelte, Express, Tailwind, etc.)
+
+## Process
+
+1. **Resolve**: Finds the library ID using `resolve-library-id` with your question as context
+2. **Select**: Picks the best match based on exact name matching and quality scores
+3. **Fetch**: Calls `query-docs` with the library ID and your specific question
+4. **Return**: Provides code examples and explanations from current documentation
+
+## Guidelines
+
+- Uses your full question as the query parameter for better relevance
+- Limited to 3 documentation calls per question to avoid overwhelming context
+- Picks version-specific IDs when you mention versions ("Next.js 15", "React 19")
+- Checks available versions from the resolution step before querying
+
+## Supported Libraries
+
+Works with any library indexed by Context7, including:
+
+- Frontend: React, Next.js, Vue, Nuxt, Svelte, SvelteKit, Solid, Astro
+- Backend: Express, Fastify, Hono, NestJS, Django, FastAPI, Rails
+- Databases: Prisma, Drizzle, Supabase, Firebase, MongoDB
+- Styling: Tailwind CSS, Styled Components, Emotion
+- And thousands more...
+
+## Example Interactions
+
+**You**: "How do I set up authentication with Supabase?"
+
+**Skill activates**:
+1. Resolves "supabase" → `/supabase/supabase`
+2. Queries with "authentication setup"
+3. Returns current auth documentation with code examples
+
+**You**: "Show me React 19 use() hook examples"
+
+**Skill activates**:
+1. Resolves "react" with version context → `/facebook/react/v19.0.0`
+2. Queries with "use hook examples"
+3. Returns React 19-specific documentation