MCP Server

The qBraid MCP server gives AI clients live access to the qBraid platform through the Model Context Protocol. Connect it once and your AI assistant can browse quantum devices, estimate costs, submit and track jobs, and manage your account.

https://mcp.qbraid.com/mcp

The server uses Streamable HTTP transport and authenticates through OAuth with your qBraid account. No API key is needed.

Connect your client

Custom connectors need a Pro, Max, Team, or Enterprise plan.

Open the pre-filled connector dialog

Click Add qBraid to Claude. The Add custom connector dialog opens with the name and server URL already filled in. Claude shows a notice that an external link suggested the connector. That is expected. Review the URL and click Add.

If the dialog doesn’t open, go to Settings → Connectors → Add custom connector and paste the URL manually:

https://mcp.qbraid.com/mcp

Click Connect and sign in with your qBraid account.

Enable it in a chat

In any conversation, open the search and tools menu and toggle qBraid on. The same connector also works in the Claude desktop app.

Add the server from your terminal:

claude mcp add --transport http qbraid https://mcp.qbraid.com/mcp

Inside Claude Code, run /mcp, select qbraid, and complete the OAuth sign-in in your browser.

Verify the connection:

claude mcp list

Add --scope user to share the server across all your projects.

Custom connectors require developer mode on a paid plan.

Enable developer mode

Open developer mode settings and turn on Developer mode.

Create the connector

Click create a connector to open the creation dialog, name it qBraid, and paste the MCP server URL:

https://mcp.qbraid.com/mcp

Choose OAuth as the authentication method, save, and sign in with your qBraid account.

Custom connectors need a Pro, Max, or Enterprise plan.

Open connector settings

Go to Perplexity connector settings and click + Custom connector, then select Remote.

Add the server

Name it qBraid and paste the MCP server URL:

https://mcp.qbraid.com/mcp

Choose OAuth authentication and Streamable HTTP transport.

Save, then sign in with your qBraid account.

Click Add qBraid to Cursor to install in one click, or add this to ~/.cursor/mcp.json yourself:

{
  "mcpServers": {
    "qbraid": { "url": "https://mcp.qbraid.com/mcp" }
  }
}

Cursor detects the server, runs the OAuth sign-in, and picks up the tools automatically.

Click Add qBraid to VS Code to install in one click, or add this to .vscode/mcp.json in your workspace:

{
  "servers": {
    "qbraid": { "type": "http", "url": "https://mcp.qbraid.com/mcp" }
  }
}

VS Code prompts for the OAuth sign-in the first time Copilot uses the server.

Add the server, then sign in:

codex mcp add qbraid --url https://mcp.qbraid.com/mcp
codex mcp login qbraid

The second command opens the OAuth sign-in in your browser. Verify with codex mcp list.

Any MCP client that supports remote servers over Streamable HTTP with OAuth can connect. Point it at:

https://mcp.qbraid.com/mcp

The server supports OAuth dynamic client registration, so most clients complete sign-in automatically after you add the URL.

Available tools

Browse 80+ tools by category

Category	Example tools
Quantum devices	`list_quantum_devices`, `get_device_details`, `get_device_calibrations`
Quantum jobs	`submit_quantum_job`, `estimate_job_cost`, `get_job_result`, `get_job_circuit_diagram`
Circuits	`validate_qasm`, `parse_qasm`, `convert_qasm`, `simulate_circuit`
Compute	`list_compute_profiles`, `start_server`, `stop_server`, `list_compute_instances`
Environments	`list_environments`, `get_environment_details`, `build_kernel`
Credits & billing	`get_my_credit_balance`, `list_billing_transactions`, `purchase_personal_credits`
Organizations	`get_organization_details`, `invite_organization_members`, `transfer_organization_credits`
Learning (qBook)	`list_qbook_articles`, `create_qbook_course`, `enroll_in_qbook_course`
Files	`list_files`, `read_file`
Support	`create_support_ticket`, `list_support_tickets`

Connected clients list the full catalog automatically. Read-only tools run without confirmation; tools that spend credits or change state report clearly what they will do first.

Example prompts

Once connected, try:

“List the QPUs online right now and estimate the cost of 1000 shots of a 5-qubit GHZ circuit on the cheapest one.”
“Show my quantum jobs from this week and explain why any failed.”
“How many credits do I have left, and what did I spend the most on this month?”
“Validate this QASM circuit and draw its diagram.”

Prefer working inside the qBraid platform? AI Chat and Agent Mode use this same MCP server with no setup.