Jina

v1.2.3Search & Data Extractionstable

A Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.

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

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

Integrate Jina AI Search Foundation APIs through MCP.
PsychArch

Maintainer

LicenseMIT
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

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
1

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.

2

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-tools
3

Add 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"
      }
    }
  }
}
4

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 vip
5

Optional: 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 3000

Jina 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.

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

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