How to Use the arXiv MCP in Windsurf

Q: Can I get the PDF link for an arXiv paper directly in Windsurf?

Yes. When you use the getarxivpaper tool with a valid ID, the results include a direct pdflink. Your Windsurf agent will show you this link along with the paper's abstract and other details.

Let Windsurf's Cascade agent find and fetch arXiv papers for you, turning a research goal into a finished summary in one autonomous step.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect arXiv MCP to Windsurf

Create your Vinkius account to connect arXiv to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup arXiv with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Find Research Without Leaving Your Editor

The `search_arxiv` tool connects Windsurf directly to the entire arXiv library. Just tell Cascade what you're looking for—no special syntax required. Ask it to find recent papers on algebraic topology or search for a specific author. It runs the search and presents the findings right in your IDE. This means you don't have to break your focus by switching to a browser. The research comes to you. Your agent can find relevant papers, letting you stay locked in on the code you're writing.

Go from Paper ID to Full Abstract Instantly

Use the `get_arxiv_paper` tool when you already have a paper's ID. Maybe you saw it on a social feed or in a document. Just give the ID to Windsurf and its Cascade agent gets the full details: title, authors, abstract, and the direct PDF link. It's faster than manually looking it up. The information appears in your editor, ready to be copied, summarized, or saved. This is perfect for quickly grabbing context on a paper you need to reference.

Run Autonomous Research with Windsurf

Here's where it gets interesting. Give Windsurf a high-level goal, and its Cascade agent chains tools together to get it done. For example: "Find the 5 most recent papers on `cs.AI` and give me their abstracts." Cascade plans the job on its own. First, it uses `search_arxiv` to find the papers. Then, it automatically runs `get_arxiv_paper` for each of the top 5 results. You don't prompt each step; you just see the final list of abstracts. This MCP Server turns your agent into a real research assistant.

Setup guide

Set up arXiv MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the arXiv MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my arXiv payment history." If connected, Cascade will call the arXiv tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "arxiv-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by arXiv. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect arXiv now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about arXiv MCP in Windsurf

You can ask Windsurf's Cascade agent in plain English, like "Search arXiv for papers by Yoshua Bengio." The agent will use the `search_arxiv` tool and format the query correctly on its own.

Yes. When you use the `get_arxiv_paper` tool with a valid ID, the results include a direct `pdf_link`. Your Windsurf agent will show you this link along with the paper's abstract and other details.

Just state your goal. For instance, say "Find the latest papers in the `q-bio.NC` category on arXiv." Windsurf will use the `search_arxiv` tool, sort by submission date, and give you the most recent results.

No. The server is stateless. Every request you make is processed in an ephemeral sandbox on Vinkius that is destroyed after your request is complete. Nothing is logged or saved.

Your queries and the resulting paper metadata (like titles, abstracts, and author names) are the only data processed. Each request runs in a dedicated, zero-trust container on Vinkius that is torn down immediately after. Your MCP token authenticates the request, but no personal data is stored.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript