How to add Jina AI Reader & Search to Windsurf

Official Jina AI remote MCP server — read web pages as Markdown and run grounded web search over HTTP. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 730★ · http · apikey · official

Windsurf config for Jina AI Reader & Search

Add remote MCP URL https://mcp.jina.ai/v1 with Authorization: Bearer <jina-api-key>

{
  "mcpServers": {
    "jina-ai-reader-search": {
      "serverUrl": "https://mcp.jina.ai/v1",
      "headers": {
        "Authorization": "Bearer <your-jina-api-key>"
      }
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Jina AI Reader & Search config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Jina AI Reader & Search's tools become available to Cascade.

Before you start

A Jina API key (free tier) from https://jina.ai — required for search and reranker tools; some read tools work key-less at lower rate limits
An MCP client with remote/HTTP support (e.g. Claude Desktop, Cursor), or `mcp-remote` as a local proxy for clients without it
Network access to the hosted endpoint `https://mcp.jina.ai/v1` — no local install needed

What Jina AI Reader & Search can do in Windsurf

read_url

Extract the content of a web page as clean Markdown (Jina Reader).

parallel_read_url

Read multiple URLs concurrently.

capture_screenshot_url

Capture a screenshot of a web page.

search_web

Run a grounded web search and return results with content.

search_images

Search for images across the web.

search_arxiv

Search academic papers and preprints on arXiv.

parallel_search_web

Run multiple web searches concurrently.

sort_by_relevance

Rerank a set of documents against a query using the Jina Reranker.

Security

Pass the JINA_API_KEY as a Bearer token stored in your client's secret config, not in shared URLs or logs. Queries and fetched pages pass through Jina's hosted infrastructure, so avoid sending sensitive data in requests.

Jina AI Reader & Search + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Jina AI Reader & Search config there under the "mcpServers" key and restart the client.

Is Jina AI Reader & Search safe to use with Windsurf?

Do I need an API key?

Search and reranker tools require a free Jina API key. Some reading tools (like read_url) work without one, but at reduced rate limits.

Where do I get the key and is it free?

Get it at https://jina.ai; there is a free tier. Higher throughput and the search tools require the key in an Authorization: Bearer header.

Is this remote or local?

It is a hosted remote server at https://mcp.jina.ai/v1 over Streamable HTTP. There is nothing to install locally.

View repo Full Jina AI Reader & Search page