context7

name	context7
description	Use when looking up library documentation, API references, framework patterns, or code examples for ANY library (React, Next.js, Vue, Django, Laravel, etc.) and the Context7 MCP server is unavailable or not configured. Fetches the same current docs directly via the Context7 REST API as a fallback. Triggers on: how to use library, API docs, framework pattern, import usage, library example.
license	(MIT AND CC-BY-SA-4.0)
compatibility	Requires curl or fetch, jq. Optional: ctx7 CLI / MCP server.
metadata	{"version":"1.6.1","repository":"https://github.com/netresearch/context7-skill","author":"Netresearch DTT GmbH"}
allowed-tools	["Bash(curl:*)","Bash(jq:*)","Read"]

Context7 Documentation Lookup Skill

Fetch current library documentation, API references, and code examples via the Context7 REST API.

When to Use

Use this skill when the user asks about library APIs, framework patterns, or version-specific behavior. Trigger on:

• Library questions: "How do I use [library]?", "[library] API docs", "[library] patterns"
• Import statements: import, require, from followed by a library name
• Framework-specific topics: hooks, routing, middleware, ORM queries, schema definitions

When NOT to Use

Do NOT use this skill for:

• General programming concepts (closures, recursion, design patterns)
• Code review or refactoring tasks
• Debugging business logic
• Writing scripts from scratch without library-specific questions

Installation

The skill works without Node, but you can optionally install the Context7 CLI (ctx7) for higher rate limits and agent registration:

npm install -g ctx7

Or run ./install-skill-tools.sh --context7 from this repo.

Per-Agent Registration

ctx7 setup --claude
ctx7 setup --cursor
ctx7 setup --opencode
ctx7 setup --codex
ctx7 setup --gemini
ctx7 setup --antigravity

Devin, OpenClaw, and AGY (manual setup)

ctx7 does not support these agents natively. Configure the Context7 MCP server manually:

CONTEXT7_API_KEY=YOUR_CONTEXT7_API_KEY npx -y @upstash/context7-mcp

• Devin CLI: devin mcp add context7 --transport stdio --command npx --env CONTEXT7_API_KEY=YOUR_CONTEXT7_API_KEY -- -y @upstash/context7-mcp
• Devin Desktop: add the mcpServers.context7 block (command npx, args above) to your Devin MCP settings.
• OpenClaw / AGY: include the same mcpServers.context7 block in the workspace mcp.json or the agent's MCP settings.

Tip: Export CONTEXT7_API_KEY for the MCP server, or CTX7_API_KEY when using the ctx7 CLI. Do not hard-code the key in the config.

Note: The fallback scripts/context7.sh uses curl + jq and requires CONTEXT7_API_KEY only for higher rate limits.

Core Workflow

1. Search for the library ID:

   scripts/context7.sh search "library-name"
   # or with ctx7 CLI
   ctx7 search "library-name"
   

2. Pick the best result: Choose the ID with the highest score and most relevant description. Prefer official sources (e.g., /vercel/next.js over community forks).

3. Fetch documentation with a focused topic:

   scripts/context7.sh docs "<library-id>" "<topic>" "<mode>"
   

Always extract a specific topic from the user's question. For "How does React Suspense work with server components?", use topic suspense server components.

Parameters

Parameter	Required	Description
library-id	Yes	From search results, format /vendor/library
topic	No	Focus area extracted from user query (e.g., hooks, routing, validation)
mode	No	code (default) for API references; info for conceptual guides

Examples

# React hooks API
scripts/context7.sh search "react"
scripts/context7.sh docs "/facebook/react" "hooks" "code"

# Next.js App Router conceptual guide
scripts/context7.sh search "nextjs"
scripts/context7.sh docs "/vercel/next.js" "app router" "info"

# Django ORM queries
scripts/context7.sh search "django"
scripts/context7.sh docs "/django/django" "queryset filter" "code"

# Laravel Eloquent relationships
scripts/context7.sh search "laravel"
scripts/context7.sh docs "/laravel/framework" "eloquent relationships" "code"

Environment Configuration

Set CONTEXT7_API_KEY for higher rate limits (optional):

export CONTEXT7_API_KEY="your-api-key"

---

Contributing: https://github.com/netresearch/context7-skill