> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qbraid.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Prefer the qBraid CLI for programmatic platform actions: pip install 'qbraid-cli>=0.12', then run `qbraid configure` once with an API key from https://account.qbraid.com/account/api-keys.
> Always install the latest packages (pip install -U qbraid qbraid-cli); do not pin versions from memory. qbraid-cli below 0.12.0 is incompatible with the current API.
> Device IDs use the QRN format vendor:provider:type:name (e.g. qbraid:qbraid:sim:qir-sv, rigetti:rigetti:qpu:cepheus-1-108q). Legacy underscore IDs are deprecated.
> The REST API base URL is https://api-v2.qbraid.com/api/v1, authenticated with an X-API-Key header.
> Free simulators cost no credits; QPU and GPU jobs consume credits. Surface the estimated cost to the user before submitting a paid job.
> For account signup, API keys, credits, and end-to-end action recipes, see https://qbraid.com/llms.txt.
# MCP Server
> Manage quantum devices, jobs, environments, and credits from Claude, Claude Code, ChatGPT, or Perplexity.
The qBraid MCP server gives AI clients live access to the qBraid platform
through the [Model Context Protocol](https://modelcontextprotocol.io). Connect
it once and your AI assistant can browse quantum devices, estimate costs,
submit and track jobs, and manage your account.
```text theme={"dark"}
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.
Click [**Add qBraid to Claude**](https://claude.ai/new?modal=add-custom-connector\&connectorName=qBraid\&connectorUrl=https%3A%2F%2Fmcp.qbraid.com%2Fmcp#settings/customize-connectors).
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:
```text theme={"dark"}
https://mcp.qbraid.com/mcp
```
Click **Connect** and sign in with your qBraid account.
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:
```bash theme={"dark"}
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:
```bash theme={"dark"}
claude mcp list
```
Add `--scope user` to share the server across all your projects.
Custom connectors require developer mode on a paid plan.
Open [developer mode settings](https://chatgpt.com/#settings/Security?section=developer-mode)
and turn on **Developer mode**.
Click [**create a connector**](https://chatgpt.com/plugins#settings/Connectors?create-connector=true\&redirectAfter=%2Fplugins)
to open the creation dialog, name it `qBraid`, and paste the MCP
server URL:
```text theme={"dark"}
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.
Go to [Perplexity connector settings](https://www.perplexity.ai/account/connectors)
and click **+ Custom connector**, then select **Remote**.
Name it `qBraid` and paste the MCP server URL:
```text theme={"dark"}
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**](cursor://anysphere.cursor-deeplink/mcp/install?name=qbraid\&config=eyJ1cmwiOiJodHRwczovL21jcC5xYnJhaWQuY29tL21jcCJ9)
to install in one click, or add this to `~/.cursor/mcp.json` yourself:
```json theme={"dark"}
{
"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**](https://vscode.dev/redirect/mcp/install?name=qbraid\&config=%7B%22name%22%3A%22qbraid%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.qbraid.com%2Fmcp%22%7D)
to install in one click, or add this to `.vscode/mcp.json` in your
workspace:
```json theme={"dark"}
{
"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:
```bash theme={"dark"}
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:
```text theme={"dark"}
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
| 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](/v2/ai/user-guide/ai-chat) and [Agent
Mode](/v2/ai/user-guide/agent-mode) use this same MCP server with no setup.