Jina MCP Tools

This MCP server lets you access Jina AI web reading and web search capabilities through a Model Context Protocol interface. You can run it locally to read web pages and perform searches, then connect your MCP clients to retrieve results and full content formats as needed.

How to use

You run the server and connect your MCP clients to perform two main actions: read web content with the reader tool and search the web with the search tool. Start the server locally and point clients at the provided HTTP endpoint or use the standard stdio transport for integrations started by another process. When using the HTTP transport, you access the MCP endpoint at the designated HTTP URL from your client applications.

How to install

Prerequisites you need before installing: a Node.js runtime (version 16 or newer) and, optionally, a Jina AI API key for enhanced features.

Option A: Run via stdio transport (local, default) using npm and npx. This setup is useful when another process launches your MCP server. Use the exact command and arguments shown below.

{
  "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"
      }
    }
  }
}

Option B: Run via HTTP transport (remote or local HTTP endpoint)

Start the server with HTTP transport on a port, optionally supplying your API key for enhanced features.

# 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

Once the server is running, connect your MCP clients to the HTTP endpoint or use the stdio transport in your local setup.

Example client connection for the HTTP endpoint (local): http://localhost:3000/mcp

Available tools

jina_reader

Extracts and reads web page content with automatic pagination and caching for quick subsequent requests.

jina_search

Search the web and retrieve partial results suitable for later expansion with jina_reader for full content.

jina_search_vip

VIP search option using svip.jina.ai for higher-capacity or higher-speed results when API key access is configured.