Skip to main content
Get up and running with Haiqu MCP (Model Context Protocol) tools in your favourite IDE or AI chat.
1

Open Claude settings

Create a ~/.claude.json file if it does not exist.
2

Configure the Haiqu MCP server

In ~/.claude.json, add:
"mcpServers": {
  "Haiqu": {
    "type": "http",
    "url": "https://api.haiqu.ai/mcp",
    "headers": {
      "Authorization": "HAIQU-API-KEY"
    }
  }
}
3

Test the connection

In Claude’s chat, ask “What Haiqu tools do you have available?” Claude should show the Haiqu MCP server as an available tool. The example output from the Claude chat:
Based on the system context, here are the available Haiqu MCP tools:

Experiments

mcp__Haiqu__create_new_experiment — create a new experiment
mcp__Haiqu__get_experiment_by_id — fetch experiment by ID
mcp__Haiqu__get_experiment_by_name — fetch experiment by name
mcp__Haiqu__list_experiments — list all experiments
mcp__Haiqu__update_experiment — update experiment metadata

...

Would you like me to use any of these?
The Haiqu documentation automatically generates llms.txt file to help AI tools index and understand the SDK and API documentation.

​
Use this documentation with AI tools

This documentation page generates an MCP server from guides and the SDK reference. It exposes a search tool for AI applications to query this documentation. To connect this documentation to AI tools do the following:
1

Open Claude settings

Open ~/.claude.json file.
2

Configure the Documentation MCP server

In ~/.claude.json, add:
"mcpServers": {
  "HaiquDocumentation": {
    "url": "https://docs.haiqu.ai/mcp"
  }
}
To test, in AI chat, ask “What HaiquDocumentation guides do you have available?” It should show the HaiquDocumentation server as an available tool.

​
Example vibe-quantum coding

In AI chat, ask “Show me the typical workflow with a simple quantum circuit.” The AI assistant should show the the complete workflow with creating a new experiment, quantum circuit, and running it on the simulator:
1

Step 1 — List devices

Identified aer_simulator as the best target: available, 0 pending jobs, 1024 qubits.
2

Step 2 — Create experiment

Experiment: "Bell State Demo"
ID: exp-6eddfc05-8336-4b9c-b5fb-dc91afb79293
Experiments are containers for circuits, jobs, and artifacts. If one with the same name already exists, it's returned instead of duplicated.
3

Step 3 — Submit circuit (via QASM)

OPENQASM 2.0;
include "qelib1.inc";
qreg q[2];
creg c[2];
h q[0];          // superposition on qubit 0
cx q[0], q[1];   // entangle q0 → q1
measure q[0] -> c[0];
measure q[1] -> c[1];
Circuits can be provided as QASM (auto-saved to the DB) or by existing circuit_id.
4

Step 4 — Poll results

Status:  Done
Device:  aer_simulator
Shots:   1024
Time:    0.09s

Results:
  |00⟩  53.4%  (534 counts)
  |11⟩  46.6%  (490 counts)

Hellinger fidelity: 0.9995
The ~50/50 split between |00⟩ and |11⟩ is exactly what a Bell state (|Φ+⟩ = (|00⟩ + |11⟩)/√2) should produce. The near-perfect fidelity confirms the simulation is clean.