List Experiments Mcp

curl --request GET \
  --url 'https://api.example.com/ai/?HAIQU_API_KEY='

[
  {
    "id": "<string>",
    "name": "<string>",
    "context": "<string>",
    "description": "",
    "creation_date": "2023-11-07T05:31:56Z",
    "tags": "",
    "circuits_count": 0,
    "jobs_count": 0,
    "last_action_date": "2023-11-07T05:31:56Z",
    "url": ""
  }
]

API Reference

List Experiments Mcp

List all experiments owned by the authenticated user.

In Haiqu, an experiment is the top-level persistent workflow container for a user’s quantum work. It groups related circuits, derived jobs, metrics, artifacts, and MCP context under one experiment_id so later tools can operate on the same workflow state.

Use this tool when the caller needs to discover available experiments before selecting one for inspection or updates. The result only includes caller-owned experiments, and an empty list is a valid outcome.

When to Use:

Call this before other experiment-scoped MCP tools when the caller does not yet know the right experiment_id.
Call this to audit available workspaces or discover stale experiments that may need follow-up.

Constraints:

Only experiments owned by the authenticated caller are returned.
An empty list is a valid result.

Notes:

Returned id values can be passed directly to experiment, circuit, job, and artifact MCP endpoints.
For agent-facing output, prefer a concise list of id and name pairs instead of dumping every field when many experiments exist.

Args: user: Authenticated user resolved from the API key. db: Active database session.

Returns: All experiments visible to the authenticated caller.

GET

List Experiments Mcp

curl --request GET \
  --url 'https://api.example.com/ai/?HAIQU_API_KEY='

[
  {
    "id": "<string>",
    "name": "<string>",
    "context": "<string>",
    "description": "",
    "creation_date": "2023-11-07T05:31:56Z",
    "tags": "",
    "circuits_count": 0,
    "jobs_count": 0,
    "last_action_date": "2023-11-07T05:31:56Z",
    "url": ""
  }
]

Authorizations

HAIQU_API_KEY

string

query

required

Response

200 - application/json

Successful Response

string

required

name

string

required

context

string

required

description

string | null

default:""

creation_date

string<date-time> | null