# Context7 Tools
> Queries version-specific library documentation from Context7. Use when fetching API references, code examples, or conceptual guides for npm/PyPI packages. Resolves library IDs, retrieves docs by topic. Not for web search.
- Skill: `majiayu000/context7-tools-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/context7-tools-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/context7-tools-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/context7-tools-3
---
# [H1][CONTEXT7-TOOLS]
>**Dictum:** *Three commands mirror MCP capabilities plus unified convenience.*
Query Context7 library documentation. Matches MCP tool structure (resolve-library-id, query-docs).
[IMPORTANT] Context7 pulls up-to-date, version-specific documentation from source. Supports private documents (early access). Community-driven library coverage.
---
## [1][COMMANDS]
| [CMD] | [ARGS] | [RETURNS] |
| ------- | ---------------------- | ------------------------------- |
| resolve | ` [query]` | Top 5 matching IDs with scores |
| docs | ` ` | Documentation filtered by query |
| lookup | ` ` | Resolve + docs in one call |
---
## [2][USAGE]
```bash
# Resolve library -> see options
uv run .claude/skills/context7-tools/scripts/context7.py resolve effect
# Resolve with query filter
uv run .claude/skills/context7-tools/scripts/context7.py resolve react "server components"
# Fetch docs for specific ID
uv run .claude/skills/context7-tools/scripts/context7.py docs /effect-ts/effect "Services"
# Unified: resolve + docs
uv run .claude/skills/context7-tools/scripts/context7.py lookup react "hooks"
# Unified: with version-specific query
uv run .claude/skills/context7-tools/scripts/context7.py lookup vite "v7 migration guide"
```
---
## [3][ARGUMENTS]
**resolve**: ` [query]`
- `library` — Library name to search (required, e.g., `effect`, `react`, `vite`)
- `query` — Optional query to narrow results
**docs**: ` `
- `library-id` — Context7 library ID (required, e.g., `/effect-ts/effect`)
- `query` — Documentation topic to retrieve (required)
**lookup**: ` `
- `library` — Library name (required)
- `query` — Topic to fetch docs for (required)
---
## [4][SELECTION_LOGIC]
`lookup` auto-selects library by: VIP status -> highest benchmark score.
Use `resolve` first when disambiguation needed (e.g., multiple React packages).
---
## [5][OUTPUT]
Commands return JSON or plain text.
| [INDEX] | [CMD] | [RESPONSE] |
| :-----: | --------- | ----------------------------------------------------- |
| [1] | `resolve` | JSON array: `[{id, title, score, vip}]` |
| [2] | `docs` | Plain text documentation prefixed with `[library-id]` |
| [3] | `lookup` | Plain text documentation (same as docs) |
---
## [6][ENVIRONMENT]
| [VAR] | [REQUIRED] | [DESCRIPTION] |
| ------------------ | ---------- | ------------------------------ |
| `CONTEXT7_API_KEY` | No | Optional bearer token for auth |
---
## [7][ERROR_HANDLING]
- HTTP errors print `[ERROR] : ` and exit 1
- Connection errors print `[ERROR] ` and exit 1
- No library found: `[ERROR] No library found for ''` and exit 1