Jina AI Remote MCP Server

A remote Model Context Protocol (MCP) server for the Jina Reader, Search, Embeddings and Reranker APIs:

Usage

[!WARNING] Some clients do not support env variable, so you may need to replace ${JINA_API_KEY} below to a hardcoded real API key jina_xxx.

For client that supports remote MCP server:

{
  "mcpServers": {
    "jina-mcp-server": {
      "url": "https://mcp.jina.ai/v1",
      "headers": {
        "Authorization": "Bearer ${JINA_API_KEY}" // optional
      }
    }
  }
}

For Claude Code:

claude mcp add -s user --transport http jina https://mcp.jina.ai/v1 \
  --header "Authorization: Bearer ${JINA_API_KEY}"

For OpenAI Codex: find ~/.codex/config.toml and add the following:

[mcp_servers.jina-mcp-server]
command = "npx"
args = [
    "-y",
    "mcp-remote",
    "https://mcp.jina.ai/v1",
    "--header",
    "Authorization: Bearer ${JINA_API_KEY}"]

For client that does not support remote MCP server yet, you need mcp-remote a local proxy to connect to the remote MCP server.

{
  "mcpServers": {
    "jina-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.jina.ai/v1",
        "--header",
        "Authorization: Bearer ${JINA_API_KEY}"
      ]
    }
  }
}

Available tools

Tool	Description	Is Jina API Key Required?
primer	Get current contextual information for localized, time-aware responses	No
read_url	Read a web page or PDF as markdown. Pass question for passages instead of the full body via Reader API	Optional*
capture_screenshot_url	Capture a screenshot of a web page via Reader API	Optional*
guess_datetime_url	Guess a page's publish or last-update datetime, with a confidence score	No
search_web	Search the web. Returns titles, URLs and engine snippets via Reader API	Yes
search_arxiv	Search academic papers and preprints on arXiv repository via Reader API	Yes
search_ssrn	Search academic papers on SSRN (Social Science Research Network) via Reader API	Yes
search_images	Search the web for images via Reader API	Yes
search_jina_blog	Search Jina AI news and blog posts at jina.ai/news	No
sort_by_relevance	Rerank documents by relevance to a query via Reranker API	Yes
deduplicate_strings	Get top-k semantically unique strings via Embeddings API and submodular optimization	Yes
extract_pdf	Extract figures, tables, and equations from PDF documents (arXiv papers or any PDF URL) using layout detection	Yes

Optional tools work without an API key at rate limits. Use a key for higher limits. Free keys: https://jina.ai

Tool Filtering before Registering

Registering a tool costs context tokens for its name, description and schema whether or not it is called. With 12 tools, that budget is spent before the first request.