Jina
A Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.
What is Jina?
Jina is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server that integrates with jina ai search foundation apis.
A Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol (MCP) server that integrates with J
Use Cases
Maintainer
Works with
Installation
NPM
npx -y jina-mcp-toolsManual Installation
npx -y jina-mcp-toolsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Jina
jina-mcp-tools is an MCP server that integrates the Jina AI Search Foundation APIs into any MCP-compatible AI client, providing tools to extract web page content with automatic pagination and to perform web searches with optional VIP endpoint access. The server caches up to 50 URLs via an LRU cache, handles multi-page documents gracefully, and converts GitHub file URLs for clean rendering. Teams building research pipelines, content aggregators, or knowledge bases use it to give Claude reliable, paginated access to live web content through a consistent MCP interface.
Prerequisites
- Node.js 18 or later installed
- An MCP client such as Claude Desktop or Claude Code
- A Jina AI API key from https://jina.ai/?sui=apikey (optional for reading, required for search)
- Network access to jina.ai endpoints
Obtain your Jina AI API key
Sign up at https://jina.ai/?sui=apikey to get a free JINA_API_KEY. The key enables the jina_search tool and increases rate limits on jina_reader.
Run jina-mcp-tools with npx
Start the server directly without installing it globally. Set the API key in your environment.
JINA_API_KEY=your_key_here npx -y jina-mcp-toolsAdd to Claude Desktop configuration
Edit claude_desktop_config.json to register jina-mcp-tools as an MCP server that starts automatically.
{
"mcpServers": {
"jina": {
"command": "npx",
"args": ["-y", "jina-mcp-tools"],
"env": {
"JINA_API_KEY": "your_key_here"
}
}
}
}Optional: use the VIP search endpoint
If you have a VIP Jina AI plan, use the --search-endpoint vip flag to route searches through the higher-rate endpoint.
JINA_API_KEY=your_key npx -y jina-mcp-tools --search-endpoint vipOptional: run in HTTP mode
Deploy the server over HTTP for use with Claude Code or team-wide access.
JINA_API_KEY=your_key npx -y jina-mcp-tools --transport http --port 3000Jina Examples
Client configuration
Claude Desktop config for jina-mcp-tools with API key and custom token-per-page setting.
{
"mcpServers": {
"jina": {
"command": "npx",
"args": ["-y", "jina-mcp-tools", "--tokens-per-page", "10000"],
"env": {
"JINA_API_KEY": "your_key_here"
}
}
}
}Prompts to try
Sample prompts using jina_reader for content extraction and jina_search for web queries.
- "Read https://arxiv.org/abs/2310.06825 and give me a structured summary"
- "Search the web for 'MCP server TypeScript tutorial 2025' and list the top 5 results"
- "Fetch the GitHub repository page at https://github.com/PsychArch/jina-mcp-tools and tell me what tools it exposes"
- "Search for recent papers on retrieval-augmented generation and summarize the abstracts"Troubleshooting Jina
jina_search tool is not available or returns an auth error
The search tool requires a JINA_API_KEY. Make sure the key is set in the env block of your MCP config, not just in your shell environment.
Large documents are returned in multiple pages and context fills up
Reduce --tokens-per-page (e.g. to 5000) to get smaller chunks, or use the page parameter in jina_reader to request a specific page number instead of reading all pages at once.
Fetching behind a proxy fails with network errors
Set the HTTP_PROXY or HTTPS_PROXY environment variable (lowercase or uppercase) in the env block of your MCP config to route requests through your proxy.
Frequently Asked Questions about Jina
What is Jina?
Jina is a Model Context Protocol (MCP) server that model context protocol (mcp) server that integrates with jina ai search foundation apis. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Jina?
Install via npm with the command: npx -y jina-mcp-tools. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Jina?
Jina works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Jina free to use?
Yes, Jina is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Jina Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Jina? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Jina in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Jina?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.