Create New Experiment

Create an experiment or return the existing experiment with the same name.

Use this tool when starting a new MCP workflow namespace and you need an experiment_id for later circuit, job, or artifact calls. Name matching is exact within the authenticated user scope, so the endpoint may return an existing experiment instead of inserting a new one.

When to Use:

• Call this at the start of a new workflow when later tool calls need a stable experiment_id.
• Call this when the user has a preferred experiment name and wants to reuse the existing experiment if it already exists.

Constraints:

• Name matching is exact and scoped to the authenticated user.
• The route may return an existing experiment instead of inserting a new one.

Notes:

• The response is the full ContextExperimentModel object, not a lightweight acknowledgment wrapper.
• For agent-facing output, surface id and name first, then summarize the context or description in one short line.

Args: user: Authenticated user resolved from the API key. data: Experiment payload containing the requested name plus optional description and MCP context. db: Active database session.

Returns: The created or reused experiment object for the caller scope.