Context7Agent - Context7 MCP

The Context7Agent class is a pre-configured AI agent that handles the complete documentation lookup workflow automatically. It combines both resolveLibraryId and queryDocs tools with an optimized system prompt.

Usage#

import { Context7Agent } from "@upstash/context7-tools-ai-sdk";import { anthropic } from "@ai-sdk/anthropic";const agent = new Context7Agent({  model: anthropic("claude-sonnet-5-5"),});const { text } = await agent.generate({  prompt: "How do I use React Server Components?",});console.log(text);

Configuration#

new Context7Agent(config: Context7AgentConfig)

Parameters#

configContext7AgentConfigrequired#

Configuration options for the agent.

Show properties

modelLanguageModelrequired#

Language model to use. Must be a LanguageModel instance from an AI SDK provider.

Examples:

anthropic('claude-sonnet-5-5')
openai('gpt-6-astra')
google('gemini-3.8-flash')

apiKeystring#

Context7 API key. If not provided, uses the CONTEXT7_API_KEY environment variable.

instructionsstring#

Custom system prompt. Overrides the default AGENT_PROMPT.

stopWhenStopCondition#

Condition for when the agent should stop. Defaults to stopping after 5 steps.

Default: "stepCountIs(5)"

Returns#

Context7Agent extends the AI SDK ToolLoopAgent class and provides generate() and stream() methods.

Agent Workflow#

The agent follows a structured multi-step workflow:

Step-by-Step#

Extract library name - Identifies the library/framework from the user’s query
Resolve library - Calls resolveLibraryId to find the Context7 library ID
Select best match - Analyzes results based on reputation, coverage, and relevance
Fetch documentation - Calls queryDocs with the selected library ID and user’s query
Query if needed - Makes additional queries if initial context is insufficient
Generate response - Provides an answer with code examples from the documentation

Examples#

Basic Usage#

import { Context7Agent } from "@upstash/context7-tools-ai-sdk";import { anthropic } from "@ai-sdk/anthropic";const agent = new Context7Agent({  model: anthropic("claude-sonnet-5-5"),});const { text } = await agent.generate({  prompt: "How do I set up authentication in Next.js?",});console.log(text);

With OpenAI#

import { Context7Agent } from "@upstash/context7-tools-ai-sdk";import { openai } from "@ai-sdk/openai";const agent = new Context7Agent({  model: openai("gpt-6-astra"),});const { text } = await agent.generate({  prompt: "Explain Tanstack Query's useQuery hook",});

Streaming Responses#

import { Context7Agent } from "@upstash/context7-tools-ai-sdk";import { anthropic } from "@ai-sdk/anthropic";const agent = new Context7Agent({  model: anthropic("claude-sonnet-5-5"),});const { textStream } = await agent.stream({  prompt: "How do I create a Supabase Edge Function?",});for await (const chunk of textStream) {  process.stdout.write(chunk);}

Custom Configuration#

import { Context7Agent } from "@upstash/context7-tools-ai-sdk";import { anthropic } from "@ai-sdk/anthropic";import { stepCountIs } from "ai";const agent = new Context7Agent({  model: anthropic("claude-sonnet-5-5"),  apiKey: process.env.CONTEXT7_API_KEY,  stopWhen: stepCountIs(8), // Allow more steps for complex queries});

Custom System Prompt#

import { Context7Agent, AGENT_PROMPT } from "@upstash/context7-tools-ai-sdk";import { openai } from "@ai-sdk/openai";const agent = new Context7Agent({  model: openai("gpt-6-astra"),  instructions: `${AGENT_PROMPT}Additional instructions:- Always include TypeScript examples- Mention version compatibility when relevant- Suggest related documentation topics`,});

Comparison: Agent vs Tools#

Feature	Context7Agent	Individual Tools
Setup	Single configuration	Configure each tool
Workflow	Automatic multi-step	Manual orchestration
System prompt	Optimized default	You provide
Customization	Limited	Full control
Best for	Quick integration	Custom workflows

When to Use the Agent#

Rapid prototyping
Standard documentation lookup use cases
When you want sensible defaults

When to Use Individual Tools#

Custom agentic workflows
Integration with other tools
Fine-grained control over the process
Custom system prompts with specific behavior

resolveLibraryId - The library search tool used by the agent
queryDocs - The documentation fetch tool used by the agent
Getting Started - Overview of the AI SDK integration