Package Exports

jina-mcp-tools
jina-mcp-tools/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (jina-mcp-tools) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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)