Jina AI MCP Tools
A Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.
Features
This MCP server provides access to the following Jina AI APIs:
- Web Reader - Extract content from web pages using r.jina.ai
- Web Search - Search the web using s.jina.ai or svip.jina.ai (configurable via
--search-endpoint)
Prerequisites
- Jina AI API Key (Optional) - Get a free API key from https://jina.ai/?sui=apikey for enhanced features
- Node.js - Version 16 or higher
MCP Server
Using stdio Transport (Default)
For local integrations spawned by another process (e.g., Claude Desktop, VS Code, Cursor):
{
"mcpServers": {
"jina-mcp-tools": {
"command": "npx",
"args": [
"jina-mcp-tools",
"--transport", "stdio",
"--tokens-per-page", "15000",
"--search-endpoint", "standard"
],
"env": {
"JINA_API_KEY": "your_jina_api_key_here_optional"
}
}
}
}
Using HTTP Transport
For remote server deployments accessible via HTTP:
Start the server:
# With API key
JINA_API_KEY=your_api_key npx jina-mcp-tools --transport http --port 3000
# Without API key (reader tool only)
npx jina-mcp-tools --transport http --port 3000
Connect from MCP clients:
- MCP Inspector:
npx @modelcontextprotocol/inspector→http://localhost:3000/mcp - Claude Code:
claude mcp add --transport http jina-tools http://localhost:3000/mcp - VS Code:
code --add-mcp '{"name":"jina-tools","type":"http","url":"http://localhost:3000/mcp"}'
CLI Options:
--transport- Transport type:stdioorhttp(default: stdio)--port- HTTP server port (default: 3000, only for HTTP transport)--tokens-per-page- Tokens per page for pagination (default: 15000)--search-endpoint- Search endpoint to use:standard(s.jina.ai) orvip(svip.jina.ai) (default: standard)
Available Tools
jina_reader
Extract and read web page content.
Parameters:
url- URL to read (required)page- Page number for paginated content (default: 1)customTimeout- Timeout override in seconds (optional)
Features:
- Automatic pagination for large documents
- LRU cache (50 URLs) for instant subsequent page requests
- GitHub file URLs automatically converted to raw content URLs
jina_search / jina_search_vip
Search the web. Returns partial content; use jina_reader for full content. Requires API key.
Tool registered depends on --search-endpoint:
jina_search→standard(s.jina.ai, default)jina_search_vip→vip(svip.jina.ai)
Parameters:
query- Search query (required)count- Number of results (default: 5)siteFilter- Limit to specific domain (e.g., "github.com")
License
MIT