QCOS MCP Server

The QCOS MCP (Model Context Protocol) server exposes all Softquantus services — QCOS, QuantumLock, and SynapseX — as structured tools that any MCP-compatible AI agent can discover and call.

This allows Claude, LangChain agents, AutoGen, CrewAI, and any other MCP-compatible framework to submit quantum circuits, generate post-quantum keys, run reranking, and query backend status — all through standard tool calls, without the agent needing to handle HTTP directly.

Architecture

AI Agent (Claude, LangChain, AutoGen, ...)
    │
    │  MCP tool calls (JSON-RPC over stdio / SSE)
    ▼
QCOS MCP Server  (softquantus-mcp)
    │
    ├──► QCOS REST API        https://api.softquantus.com/v2
    ├──► QuantumLock REST API https://lock.softquantus.com/v2
    └──► SynapseX REST API    https://synapsex.softquantus.com/v1
             │
             ├──► IBM Quantum
             ├──► IonQ
             ├──► AWS Braket
             ├──► Azure Quantum
             └──► On-prem QPUs / GPU simulators

Install

pip install softquantus-mcp

Or with uvx (no install required):

uvx softquantus-mcp

Configure in Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "softquantus": {
      "command": "uvx",
      "args": ["softquantus-mcp"],
      "env": {
        "QCOS_API_KEY": "sk-your-api-key",
        "QCOS_BASE_URL": "https://api.softquantus.com"
      }
    }
  }
}

Restart Claude Desktop. The softquantus server will appear in the tools panel.

Configure in a custom agent

import anthropic

client = anthropic.Anthropic()

# List available MCP tools
response = client.beta.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    mcp_servers=[
        {
            "type": "url",
            "url": "https://mcp.softquantus.com/sse",
            "name": "softquantus",
            "authorization_token": "sk-your-api-key",
        }
    ],
    messages=[
        {
            "role": "user",
            "content": "List available quantum backends and run a Bell state circuit on the least busy one.",
        }
    ],
    betas=["mcp-client-2025-04-04"],
)

What the server exposes

Namespace	Tools	Description
qcos_*	12 tools	Circuit submission, job management, backend control, calibration
quantumlock_*	6 tools	Key generation, verification, revocation, license validation
synapsex_*	4 tools	Reranking, inference, embedding, model listing

See the Tools Reference for the full list.

Authentication scopes

Your API key controls which tools are available. Keys are created in the Portal.

Scope	Tools unlocked
qcos:read	qcos_list_backends, qcos_get_job_result, qcos_get_job_status
qcos:execute	All qcos_* tools including circuit submission
quantumlock:read	quantumlock_verify_license, quantumlock_get_key_status
quantumlock:write	All quantumlock_* tools
synapsex:inference	All synapsex_* tools

Next steps

• MCP Quickstart — run your first agent tool call in 5 minutes
• Tools Reference — full parameter and return type reference
• Agent Integration Guide — end-to-end agent architecture