Installation

npx @upstash/context7-mcp --transport http --port 3000

import { Context7 } from '@upstash/context7-sdk';

// Initialize with API key
const ctx7 = new Context7({
  apiKey: 'ctx7sk_...' // or set CONTEXT7_API_KEY env var
});

// Search for libraries
const libraries = await ctx7.searchLibrary(
  'How to set up authentication?',
  'next.js',
  { type: 'json' }
);

console.log(libraries);
// [
//   {
//     id: '/vercel/next.js',
//     name: 'Next.js',
//     description: 'The React Framework for the Web',
//     codeSnippets: 1250,
//     reputation: 'High',
//     benchmarkScore: 98,
//     versions: ['15.1.5', '14.2.0', ...]
//   }
// ]

// Get documentation for a library
const docs = await ctx7.getContext(
  'How to create middleware?',
  '/vercel/next.js',
  { type: 'json' }
);

console.log(docs);
// [
//   {
//     type: 'code',
//     content: 'export function middleware(request) {...}',
//     title: 'Basic Middleware',
//     url: 'https://nextjs.org/docs/middleware'
//   },
//   ...
// ]

await ctx7.searchLibrary(
  query: string,        // User's question/task
  libraryName: string,  // Library name to search
  options?: {
    type: 'json' | 'txt'  // Response format (default: 'json')
  }
): Promise<Library[] | string>

await ctx7.getContext(
  query: string,      // User's question/task
  libraryId: string,  // Context7 library ID (e.g., '/vercel/next.js')
  options?: {
    type: 'json' | 'txt'  // Response format (default: 'json')
  }
): Promise<Documentation[] | string>

import { Context7, Context7Error } from '@upstash/context7-sdk';

try {
  const ctx7 = new Context7({ apiKey: 'invalid' });
  await ctx7.searchLibrary('query', 'library');
} catch (error) {
  if (error instanceof Context7Error) {
    console.error('Context7 error:', error.message);
  }
}

# Interactive setup
npx ctx7 setup

# Setup for specific agent
npx ctx7 setup --cursor
npx ctx7 setup --claude
npx ctx7 setup --opencode

# Project-specific setup
npx ctx7 setup --project

# Use existing API key
npx ctx7 setup --api-key ctx7sk_...

# Use OAuth endpoint
npx ctx7 setup --oauth

# Log in with OAuth
npx ctx7 auth login

# Log out
npx ctx7 auth logout

# Check login status
npx ctx7 auth status

# Search for skills
npx ctx7 skills search pdf

# Install skills
npx ctx7 skills install /anthropics/skills

# List installed skills
npx ctx7 skills list

# Remove skills
npx ctx7 skills remove skillname

import { resolveLibraryId, queryDocs } from '@upstash/context7-tools-ai-sdk';
import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';

const { text } = await generateText({
  model: openai('gpt-4o'),
  prompt: 'How do I create middleware in Next.js?',
  tools: {
    resolveLibraryId: resolveLibraryId({ apiKey: 'ctx7sk_...' }),
    queryDocs: queryDocs({ apiKey: 'ctx7sk_...' })
  },
  maxSteps: 5
});

console.log(text);

import { resolveLibraryId } from '@upstash/context7-tools-ai-sdk';

const tool = resolveLibraryId({
  apiKey: 'ctx7sk_...' // optional, uses CONTEXT7_API_KEY env var if not provided
});

import { queryDocs } from '@upstash/context7-tools-ai-sdk';

const tool = queryDocs({
  apiKey: 'ctx7sk_...' // optional, uses CONTEXT7_API_KEY env var if not provided
});

import { Context7Agent } from '@upstash/context7-tools-ai-sdk';
import { openai } from '@ai-sdk/openai';

const agent = new Context7Agent({
  model: openai('gpt-4o'),
  apiKey: 'ctx7sk_...',
  maxSteps: 5
});

const result = await agent.run(
  'Show me how to implement caching in Redis with Node.js'
);

console.log(result.text);

import {
  SYSTEM_PROMPT,
  AGENT_PROMPT,
  RESOLVE_LIBRARY_ID_DESCRIPTION,
  QUERY_DOCS_DESCRIPTION
} from '@upstash/context7-tools-ai-sdk';

export CONTEXT7_API_KEY=ctx7sk_...

CONTEXT7_API_KEY=ctx7sk_...