How to Use the CERN Open Data MCP in Windsurf
Connect Windsurf to CERN Open Data. Cascade chains complex physics queries into working analysis scripts without asking permission.
Works with every AI agent you already use
…and any MCP-compatible client
Connect CERN Open Data MCP to Windsurf
Create your Vinkius account to connect CERN Open Data 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.
Analyze CERN Open Data with Windsurf
The `get_portal_statistics` tool pulls the complete breakdown of available CERN data directly into your Windsurf workspace. Cascade reads this top-level metadata, mapping out record types, data-taking years, and event counts before you even write a line of code. You can ask your agent to find specific physics domains, and it will autonomously run `list_categories` to grab dataset counts for Higgs searches or heavy-ion collisions. This gives your IDE a direct line to massive particle physics archives. If you need a starting point for a new analysis project, Cascade executes `list_experiments` to check the 52,000 datasets from CMS or the LEP-era DELPHI records. The agent chains these discovery tools together to build out your project scaffolding in seconds.
Filter massive collision datasets
The `search_datasets` tool executes full-text queries against the entire CERN archive right from your editor. Windsurf can filter the results by specific parameters, using `search_by_collision_energy` to isolate 13 TeV proton-proton collisions from LHC Run 2. Instead of manually clicking through a web portal, your agent handles the complex query syntax and pagination automatically. You get precise control over the physics parameters you want to analyze. Cascade will run `search_by_collision_type` to separate electron-positron data from lead-lead collisions based on your prompt. Once it finds the right records, it immediately starts writing the Python code needed to process those specific event topologies.
Extract raw files and metadata
The `get_record` tool fetches complete metadata for any specific dataset, including authors, collision parameters, and direct links to the data. Windsurf takes this information and uses `list_record_files` to map out the exact ROOT or EOS URIs needed for your analysis script. If you drop a publication link into the chat, Cascade hits `get_record_by_doi` to find the exact datasets behind that paper. Physics terminology rarely trips up your workflow anymore. When building educational tools or documentation, the agent queries `get_glossary` to pull precise definitions for terms like transverse momentum or pseudorapidity. The MCP Server ensures your code references actual CERN definitions and live file paths.
Set up CERN Open Data 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 CERN Open Data MCP
Paste the JSON snippet shown on the right into the
mcpServersobject. 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 CERN Open Data payment history." If connected, Cascade will call the CERN Open Data tools directly. You will see a green dot next to the server name in the MCP panel.
{
"mcpServers": {
"cern-open-data-mcp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by CERN Open Data. 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.
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 CERN Open Data MCP in Windsurf
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the CERN Open Data MCP today
We host it, we monitor it, we maintain it. You just paste one token.
