Context7

On-demand library documentation for your development workflow.

---

Overview

Context7 provides up-to-date library documentation via MCP. Instead of relying on training data (which may be outdated), skills can fetch current API references, code examples, and architecture guides directly from library documentation sources.

Status: Available (shipped v7.4.0)

Skills using this connector: dev-docs-fetch

---

MCP Tools

Tool	Purpose
mcp__context7__resolve-library-id	Convert a library name (e.g., "fastapi") to a Context7-compatible ID (e.g., "/tiangolo/fastapi")
mcp__context7__get-library-docs	Fetch documentation for a resolved library ID with mode selection

---

Setup

Claude Code

Pre-configured in jaan-to v7.4.0+. The configuration lives in .mcp.json at the plugin root:

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

No additional setup required. The server is installed and run automatically via npx when a skill needs it.

Codex

The jaan-to installer automatically configures Context7 in ~/.codex/config.toml:

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

Manual alternatives:

# Via Codex CLI
codex mcp add context7 -- npx -y @upstash/context7-mcp@latest

# Or edit ~/.codex/config.toml directly

To skip MCP during install: bash scripts/install-codex-skillpack.sh --no-mcp

Verify it works: Run /dev-docs-fetch react — if Context7 resolves the library and returns documentation, the MCP connection is active.

---

Using /dev-docs-fetch

The dev-docs-fetch skill is the primary way to interact with Context7.

Basic Usage

# Fetch docs for specific libraries
/dev-docs-fetch fastapi openai react

# Auto-detect from your tech stack
/dev-docs-fetch

# The skill reads $JAAN_CONTEXT_DIR/tech.md to find your libraries

What Happens

1. Parse input — Reads library names from arguments, or auto-detects from tech.md
2. Check cache — Looks for existing docs in $JAAN_OUTPUTS_DIR/dev/docs/context7/
3. Report status — Shows FRESH (skip), STALE (re-fetch), or MISSING (fetch) per library
4. HARD STOP — Asks for confirmation before fetching
5. Fetch — Resolves library IDs and fetches documentation via Context7 MCP
6. Store — Saves with YAML frontmatter for metadata tracking

Fetch Modes

Mode	Flag	Content
code (default)	No flag needed	API references + code examples
info	Specify in prompt	Architecture, concepts, design patterns

You can also request a specific topic (e.g., "middleware", "streaming") to get more focused documentation.

---

Cache Management

Location

$JAAN_OUTPUTS_DIR/dev/docs/context7/
├── fastapi.md
├── react.md
├── sqlalchemy.md
└── ...

TTL

Cache entries have a 7-day TTL. After 7 days, entries are marked STALE and will be re-fetched on the next run.

Manual Refresh

rm -rf jaan-to/outputs/dev/docs/context7/
/dev-docs-fetch

File Format

Each cached file includes YAML frontmatter:

---
title: FastAPI Documentation
library_id: /tiangolo/fastapi
type: context7-reference
created: 2026-02-22
updated: 2026-02-22
context7_mode: code
topic: null
tags: [context7, fastapi, technical-reference]
source: Context7 MCP
cache_ttl: 7 days
---

---

Integration with Other Skills

dev-docs-fetch works as a context enrichment step in other skills' workflows:

Skill	How It Benefits
backend-scaffold	Generates more accurate code with current API references
frontend-scaffold	Uses current component patterns and hooks
backend-task-breakdown	Plans tasks with awareness of library capabilities
frontend-task-breakdown	Breaks down work knowing available framework features
dev-project-assemble	Configures projects with current best practices

In team-ship, Backend and Frontend teammates run dev-docs-fetch as their first skill to cache library context before scaffolding.

---

Troubleshooting

MCP Server Not Starting

1. Ensure npx is available in your PATH
2. Check network connectivity — the server is downloaded on first use
3. Try manually: npx -y @upstash/context7-mcp@latest

Codex: MCP Server Not Configured

If dev-docs-fetch fails with MCP tool errors in Codex:

1. Check ~/.codex/config.toml includes the [mcp_servers.context7] section
2. Re-run the installer: bash scripts/install-codex-skillpack.sh --force
3. Or manually add: codex mcp add context7 -- npx -y @upstash/context7-mcp@latest
4. Restart Codex after configuration changes

Library Not Found

• Try the full package name (e.g., @tanstack/react-query instead of react-query)
• The skill offers retry with alternative names when a library is not found
• You can skip unavailable libraries and continue with the rest

Network Errors

The skill retries up to 3 times with backoff on network failures. If all retries fail:

• Stale cache is offered as a fallback (if available)
• You can skip the failing library and continue

---

Back to MCP Connectors