How to Use the IBM Quantum MCP in Windsurf

Q: How do I link IBM Quantum to Windsurf?

Open your mcpconfig.json file in your home directory. Add this server under the mcpServers key, save the file, and hit refresh in the MCP panel to start.

Q: Can Windsurf handle IBM Quantum results autonomously?

Yes. If you provide a goal, Cascade uses getjobresult to pull the data and format it into your editor. It reads the raw output and presents the findings.

Run quantum circuits directly from Windsurf. Let Cascade manage your job lifecycle, backend selection, and data analysis.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IBM Quantum MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate circuit execution in Windsurf

Cascade doesn't wait for you to fetch data. It uses `list_backends` to find the right hardware and `submit_job` to push your code to the queue. Once the job hits the hardware, it handles the polling logic. It waits for the status to change and pulls the final output for your review.

Monitor quantum jobs across your project

You don't need to leave your workspace to check on progress. The agent triggers `list_jobs` to show you everything currently running or finished. If a circuit is stuck or you need to clear the queue, it calls `cancel_job` instantly. This keeps your compute budget under control while you iterate.

Deep dive into backend performance

Getting the right hardware matters for fidelity. This MCP server lets you run `get_backend_details` to verify if a system supports your specific gates. It compares specs before you spend your credits. This ensures you aren't wasting time on hardware that can't handle your circuit depth.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "ibm-quantum-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 IBM Quantum. 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 IBM Quantum 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 IBM Quantum MCP in Windsurf

Open your mcp_config.json file in your home directory. Add this server under the mcpServers key, save the file, and hit refresh in the MCP panel to start.

Yes. If you provide a goal, Cascade uses `get_job_result` to pull the data and format it into your editor. It reads the raw output and presents the findings.

Your API tokens never leave your local environment. The connection is restricted to your machine, and only you control which jobs are submitted to the IBM hardware.

The server returns the error state through the MCP protocol. Your agent reads the error details and can automatically attempt a fix or notify you.

Your circuit definitions are transmitted directly to IBM over an encrypted channel. No intermediate storage or third-party logging occurs during the job lifecycle.

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