Jina AI

v1.2.3Search & Data Extractionstable

Integrates Jina AI Search Foundation APIs to provide web page content extraction and search capabilities. It supports automatic pagination, result caching, and both standard and VIP search endpoints for enhanced information retrieval.

jinaaimcpmodel-context-protocolsearch
Share:
42
Stars
0
Downloads
0
Weekly
0/5

What is Jina AI?

Jina AI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to integrates jina ai search foundation apis to provide web page content extraction and search capabilities. it supports automatic pagination, result caching, and both standard and vip search endpoints f...

Integrates Jina AI Search Foundation APIs to provide web page content extraction and search capabilities. It supports automatic pagination, result caching, and both standard and VIP search endpoints for enhanced information retrieval.

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Integrates Jina AI Search Foundation APIs to provide web pag

Use Cases

Extract web page content with Jina AI Search Foundation.
Perform web searches with automatic pagination.
Cache results and access VIP search endpoints.
PsychArch

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.2.3
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y jina-mcp-tools

Manual Installation

npx -y jina-mcp-tools

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Jina AI

Jina AI MCP Tools connects your AI assistant to the Jina AI Search Foundation APIs, giving it the ability to extract full web page content and perform web searches with automatic pagination and LRU caching. It exposes a jina_reader tool for reading URLs (including GitHub files) and jina_search tools for querying the web — either via the standard endpoint or the higher-rate VIP endpoint. Developers and researchers use it to give Claude or other MCP clients reliable, paginated access to live web content without building their own scraping infrastructure.

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 but required for search features)
  • Network access to jina.ai endpoints
1

Obtain a Jina AI API key

Visit https://jina.ai/?sui=apikey and sign up for a free account to get your JINA_API_KEY. The key is optional for basic web reading but is required to use jina_search or jina_search_vip.

2

Run the server via npx

You can start the server directly with npx — no global install needed. Pass your API key as an environment variable.

JINA_API_KEY=your_key_here npx jina-mcp-tools
3

Configure Claude Desktop

Add the server to your Claude Desktop configuration file (claude_desktop_config.json) so it starts automatically when Claude launches.

{
  "mcpServers": {
    "jina": {
      "command": "npx",
      "args": ["-y", "jina-mcp-tools"],
      "env": {
        "JINA_API_KEY": "your_key_here"
      }
    }
  }
}
4

Optional: run in HTTP mode

For team deployments or when connecting from Claude Code, you can run jina-mcp-tools as an HTTP server and point your MCP client at the endpoint URL.

JINA_API_KEY=your_key npx jina-mcp-tools --transport http --port 3000
5

Tune pagination and cache settings

Control how many tokens per page are returned and how many URLs are cached. Defaults are 15000 tokens per page and 50 cached URLs.

JINA_API_KEY=your_key npx jina-mcp-tools --tokens-per-page 8000 --cache-size 100

Jina AI Examples

Client configuration

Full Claude Desktop JSON config for jina-mcp-tools with API key and VIP search endpoint.

{
  "mcpServers": {
    "jina": {
      "command": "npx",
      "args": ["-y", "jina-mcp-tools", "--search-endpoint", "vip"],
      "env": {
        "JINA_API_KEY": "your_key_here"
      }
    }
  }
}

Prompts to try

Sample prompts that exercise the jina_reader and jina_search tools.

- "Read the content of https://en.wikipedia.org/wiki/Model_context_protocol and summarize it"
- "Search the web for 'LLM context window benchmarks 2025' and list the top findings"
- "Fetch all pages from https://docs.example.com/api and give me a summary of each section"
- "Search for recent news about Jina AI embeddings and cite your sources"

Troubleshooting Jina AI

jina_search returns an error saying an API key is required

The search tools require a valid JINA_API_KEY. Make sure the env var is set in your MCP config or shell before launching the server.

Large pages are truncated or cut off

Use the page parameter in jina_reader to retrieve subsequent pages, or increase --tokens-per-page when starting the server to fit more content per request.

Requests fail behind a corporate proxy

Set HTTP_PROXY or HTTPS_PROXY environment variables to your proxy URL; jina-mcp-tools reads these automatically.

Frequently Asked Questions about Jina AI

What is Jina AI?

Jina AI is a Model Context Protocol (MCP) server that integrates jina ai search foundation apis to provide web page content extraction and search capabilities. it supports automatic pagination, result caching, and both standard and vip search endpoints for enhanced information retrieval. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Jina AI?

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 AI?

Jina AI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Jina AI free to use?

Yes, Jina AI is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

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.

Quick Config Preview

{ "mcpServers": { "jina-ai-mcp-tools": { "command": "npx", "args": ["-y", "jina-mcp-tools"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Jina AI?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides