io.github.Blite-HQ/qnexus-mcp MCP Server

Name: io.github.Blite-HQ/qnexus-mcp MCP Server
Author: io.github.Blite-HQ

io.github.Blite-HQ/qnexus-mcp

Repository Registry

What is the io.github.Blite-HQ/qnexus-mcp MCP server?

MCP server for Quantinuum Nexus, wrapping the qnexus SDK. Not affiliated with Quantinuum.

How to install io.github.Blite-HQ/qnexus-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

QNEXUS_MCP_TOOLSETS
Comma-separated toolsets: read,execute,manage,destructive (default: read).
QNEXUS_MCP_ALLOW_SPEND
Permit credit-spending (HQC) execution (default: false).
QNEXUS_MCP_ALLOW_HARDWARE
Permit real-QPU targets (default: false).
QNEXUS_MCP_ALLOW_DESTRUCTIVE
Permit delete/cancel/archive tools (default: false).
QNEXUS_MCP_MAX_CREDITS
Hard per-call HQC ceiling; 0 blocks all spend (default: 0).
QNEXUS_MCP_MAX_OUTCOMES
Top-N cap on distinct measurement outcomes returned per result item (default: 100).
QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE
Sliding-window submission cap; each circuit in a batch counts as one (default: 6).
QNEXUS_MCP_PROJECTS
Comma-separated project allowlist, enforced on every mutating tool (default: all projects).

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "qnexus-mcp": {
      "command": "uvx",
      "args": [
        "qnexus-mcp"
      ],
      "env": {
        "QNEXUS_MCP_TOOLSETS": "<YOUR_QNEXUS_MCP_TOOLSETS>",
        "QNEXUS_MCP_ALLOW_SPEND": "<YOUR_QNEXUS_MCP_ALLOW_SPEND>",
        "QNEXUS_MCP_ALLOW_HARDWARE": "<YOUR_QNEXUS_MCP_ALLOW_HARDWARE>",
        "QNEXUS_MCP_ALLOW_DESTRUCTIVE": "<YOUR_QNEXUS_MCP_ALLOW_DESTRUCTIVE>",
        "QNEXUS_MCP_MAX_CREDITS": "<YOUR_QNEXUS_MCP_MAX_CREDITS>",
        "QNEXUS_MCP_MAX_OUTCOMES": "<YOUR_QNEXUS_MCP_MAX_OUTCOMES>",
        "QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE": "<YOUR_QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE>",
        "QNEXUS_MCP_PROJECTS": "<YOUR_QNEXUS_MCP_PROJECTS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "qnexus-mcp": {
      "command": "uvx",
      "args": [
        "qnexus-mcp"
      ],
      "env": {
        "QNEXUS_MCP_TOOLSETS": "<YOUR_QNEXUS_MCP_TOOLSETS>",
        "QNEXUS_MCP_ALLOW_SPEND": "<YOUR_QNEXUS_MCP_ALLOW_SPEND>",
        "QNEXUS_MCP_ALLOW_HARDWARE": "<YOUR_QNEXUS_MCP_ALLOW_HARDWARE>",
        "QNEXUS_MCP_ALLOW_DESTRUCTIVE": "<YOUR_QNEXUS_MCP_ALLOW_DESTRUCTIVE>",
        "QNEXUS_MCP_MAX_CREDITS": "<YOUR_QNEXUS_MCP_MAX_CREDITS>",
        "QNEXUS_MCP_MAX_OUTCOMES": "<YOUR_QNEXUS_MCP_MAX_OUTCOMES>",
        "QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE": "<YOUR_QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE>",
        "QNEXUS_MCP_PROJECTS": "<YOUR_QNEXUS_MCP_PROJECTS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "qnexus-mcp": {
      "command": "uvx",
      "args": [
        "qnexus-mcp"
      ],
      "env": {
        "QNEXUS_MCP_TOOLSETS": "<YOUR_QNEXUS_MCP_TOOLSETS>",
        "QNEXUS_MCP_ALLOW_SPEND": "<YOUR_QNEXUS_MCP_ALLOW_SPEND>",
        "QNEXUS_MCP_ALLOW_HARDWARE": "<YOUR_QNEXUS_MCP_ALLOW_HARDWARE>",
        "QNEXUS_MCP_ALLOW_DESTRUCTIVE": "<YOUR_QNEXUS_MCP_ALLOW_DESTRUCTIVE>",
        "QNEXUS_MCP_MAX_CREDITS": "<YOUR_QNEXUS_MCP_MAX_CREDITS>",
        "QNEXUS_MCP_MAX_OUTCOMES": "<YOUR_QNEXUS_MCP_MAX_OUTCOMES>",
        "QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE": "<YOUR_QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE>",
        "QNEXUS_MCP_PROJECTS": "<YOUR_QNEXUS_MCP_PROJECTS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "qnexus-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "qnexus-mcp"
      ],
      "env": {
        "QNEXUS_MCP_TOOLSETS": "<YOUR_QNEXUS_MCP_TOOLSETS>",
        "QNEXUS_MCP_ALLOW_SPEND": "<YOUR_QNEXUS_MCP_ALLOW_SPEND>",
        "QNEXUS_MCP_ALLOW_HARDWARE": "<YOUR_QNEXUS_MCP_ALLOW_HARDWARE>",
        "QNEXUS_MCP_ALLOW_DESTRUCTIVE": "<YOUR_QNEXUS_MCP_ALLOW_DESTRUCTIVE>",
        "QNEXUS_MCP_MAX_CREDITS": "<YOUR_QNEXUS_MCP_MAX_CREDITS>",
        "QNEXUS_MCP_MAX_OUTCOMES": "<YOUR_QNEXUS_MCP_MAX_OUTCOMES>",
        "QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE": "<YOUR_QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE>",
        "QNEXUS_MCP_PROJECTS": "<YOUR_QNEXUS_MCP_PROJECTS>"
      }
    }
  }
}

Claude Code

claude mcp add qnexus-mcp --env QNEXUS_MCP_TOOLSETS=<YOUR_QNEXUS_MCP_TOOLSETS> --env QNEXUS_MCP_ALLOW_SPEND=<YOUR_QNEXUS_MCP_ALLOW_SPEND> --env QNEXUS_MCP_ALLOW_HARDWARE=<YOUR_QNEXUS_MCP_ALLOW_HARDWARE> --env QNEXUS_MCP_ALLOW_DESTRUCTIVE=<YOUR_QNEXUS_MCP_ALLOW_DESTRUCTIVE> --env QNEXUS_MCP_MAX_CREDITS=<YOUR_QNEXUS_MCP_MAX_CREDITS> --env QNEXUS_MCP_MAX_OUTCOMES=<YOUR_QNEXUS_MCP_MAX_OUTCOMES> --env QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE=<YOUR_QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE> --env QNEXUS_MCP_PROJECTS=<YOUR_QNEXUS_MCP_PROJECTS> -- uvx qnexus-mcp