• HARDWARE
  • EXECUTION
  • STATUS
  • HUMAN

How to execute quantum circuits with your AI

Connect IBM Quantum to your agent to bridge the gap between high-level code and real quantum hardware.

Ask AI about this page

Short answer

How can I run quantum circuits using my AI?

Your agent uses the IBM Quantum MCP to check which backends are online and then sends your circuits to them. You get the results of your quantum jobs without leaving your chat window. This breakdown shows how the agent handles hardware selection and job submission.

The outcomes of your request.

Where your work lands.

Once you give your agent a circuit, it handles the heavy lifting on the IBM side.

HARDWARE

Available backends identified

The agent scans the IBM Quantum fleet to find a suitable processor. You get a list of real hardware options to choose from.

EXECUTION

Quantum jobs submitted

The agent sends your specific circuit to the selected backend. Your job enters the IBM queue immediately.

STATUS

Job tracking active

The agent monitors the progress of your circuit. You can ask for updates on whether the job is still running or finished.

HUMAN

Manual circuit design

The agent cannot invent quantum algorithms for you. You still need to provide the actual circuit logic or code to be executed.

The workflow

What your AI does when a circuit arrives.

The agent acts as the interface between your natural language instructions and the IBM Quantum API.

  1. Scan hardware

    The agent looks for active quantum processors that meet your requirements.

    list_backends

  2. Select backend

    The agent picks the best available machine based on your constraints.

    list_backends

  3. Send circuit

    The agent pushes your quantum circuit to the chosen IBM hardware.

    submit_job

  4. Confirm submission

    The agent verifies the job was accepted by the IBM system.

    submit_job

Try it

Copy these to start.

Use these prompts to kick off your quantum experiments.

Starting points

These are opening lines. Swap out the circuit descriptions for your actual quantum code.

IBM Quantum Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_NNHeCVFOguqiuPjrZJyiewB5nLuhf0h5ZUHGe8Ks/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — IBM Quantum capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "ibm-quantum-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_NNHeCVFOguqiuPjrZJyiewB5nLuhf0h5ZUHGe8Ks/mcp"
    }
  }
}
Copy into chat04

  • List all available IBM Quantum backends so I can choose one.

  • Find an available backend and submit this quantum circuit: [paste circuit code here].

  • Which IBM Quantum backends are currently online and ready for jobs?

  • Submit my Bell state circuit to the most stable backend available.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect IBM Quantum once, then ask.

Just link your IBM Quantum account to Vinkius. Your credentials stay encrypted and secure, and you can start running jobs in any MCP-compatible client.

Connect IBM Quantum to your AI

FAQ

How this task behaves.

  • 01

    Can the AI write the quantum circuit for me?

    No. You must provide the circuit or the logic you want to execute. The agent only handles the submission and hardware interaction.

  • 02

    How does the AI know which hardware to use?

    The agent uses the list of available backends to find a machine that matches your request.

  • 03

    Can the AI delete my existing IBM Quantum jobs?

    No. The agent only has tools to list backends and submit new jobs. It cannot manage or delete your historical job data.

  • 04

    Does the AI handle the quantum error correction?

    No. Error correction is handled by the specific IBM backend you choose to run the job on.

  • 05

    Can I run jobs on simulators instead of real hardware?

    Yes, if the backend returned by the system is a simulator, the agent will submit the job there.

  • More questions about IBM Quantum? The Connector page answers them. See everything the IBM Quantum Connector can do

Connect IBM Quantum to Claude, Cursor, ChatGPT & more