How to Use the DataCite REST MCP in Windsurf

Q: How does Windsurf use DataCite REST to find related research?

Windsurf's Cascade agent can use the listevents tool to find connections between DOIs. You can ask it to find all citations or references for a specific paper, and it will query the DataCite REST API to get you the linked resource metadata.

Q: What's the difference between listclients and listproviders?

The listclients tool shows you DataCite Repository accounts. In contrast, listproviders gives you a list of the top-level DataCite Members and Consortium Organizations. Use clients for repository-specific info and providers for organizational data.

Let Windsurf's Cascade autonomously manage DOIs and pull research data for your projects.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect DataCite REST MCP to Windsurf

Create your Vinkius account to connect DataCite REST 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 DataCite REST with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit Your Research Data

This MCP Server connects Windsurf to the DataCite API. You can ask Cascade to find all citations for your team's DOIs from last quarter. It figures out the steps on its own, using `list_dois` to find the records and then `list_events` to trace the citations for each one. What you get is a clean report, not a list of raw data from a dozen manual queries. Cascade chains the commands together so you don't have to prompt it for every single step. It's the difference between asking for data and just getting the answer.

Manage DOIs Without Leaving Your IDE

You can tell Cascade to create, update, or even delete DOIs right from your editor. To get started, just connect your DataCite Member account credentials to the server. A word of caution: the `delete_doi` tool only works on records in a draft state. For example, give Cascade a local JSON file and say, "Create a new DOI for this dataset." It will format the payload and run the `create_doi` tool. No more switching over to a web portal or writing one-off scripts to manage your records.

Check API Health and Data History

Need to know if the DataCite API is up? Just ask Windsurf. It'll hit the `get_heartbeat` tool for a quick status check. It’s a simple way to confirm the service is online before you run a big job. You can also ask for the history of a specific DOI. Cascade uses `list_activities` to pull the full metadata provenance, showing you every change made to a record over time. It's perfect for tracking down unexpected updates or auditing data lineage.

Setup guide

Set up DataCite REST 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 DataCite REST 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 DataCite REST payment history." If connected, Cascade will call the DataCite REST tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "datacite-rest-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 DataCite. 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 DataCite REST 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 DataCite REST MCP in Windsurf

Windsurf's Cascade agent can use the `list_events` tool to find connections between DOIs. You can ask it to find all citations or references for a specific paper, and it will query the DataCite REST API to get you the linked resource metadata.

Point Windsurf to a local file with your metadata and tell Cascade to create a new DOI. It will use the `create_doi` tool, format the payload correctly for the DataCite REST API, and handle the authenticated request for you.

Yes. Just ask Windsurf for the history of a specific DOI. Its Cascade agent will use the `list_activities` tool from the DataCite REST MCP Server to pull the full provenance record and show you all the changes.

The `list_clients` tool shows you DataCite Repository accounts. In contrast, `list_providers` gives you a list of the top-level DataCite Members and Consortium Organizations. Use clients for repository-specific info and providers for organizational data.

This server only processes the DOI metadata and research record information you query or submit. Each request runs in an ephemeral Vinkius sandbox that is destroyed after execution. Your authentication token is the only key, and it's never stored with the request logs.

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