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: stdio or http (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) or vip (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)