# invarium

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add invarium-ai/invarium

# Browse available tools
npx -y @smithery/cli@latest tool list invarium-ai/invarium

# Get full schema for a tool
npx -y @smithery/cli@latest tool get invarium-ai/invarium invarium_get_workflow

# Call a tool
npx -y @smithery/cli@latest tool call invarium-ai/invarium invarium_get_workflow '{}'
```

## Direct MCP Connection

Endpoint: `https://invarium--invarium-ai.run.tools`

**Required config:**
- `headers` (query) — {
        "Authorization": "Bearer inv_xxxxx"
      }

## Tools (19)

- `invarium_get_workflow` — Get the complete Invarium QA workflow or a specific phase.
- `invarium_connect` — Verify your API key and connect to the Invarium platform.
- `invarium_list_agents` — List all agents registered in your Invarium workspace.
- `invarium_prepare_blueprint` — Validate and preview an agent blueprint BEFORE uploading to Invarium.
- `invarium_upload_blueprint` — Upload an agent blueprint to the Invarium dashboard.
- `invarium_generate_tests` — Generate a behavioral test scenario with test cases for your agent.
- `invarium_get_tests` — Retrieve test cases for your agent.
- `invarium_list_scenarios` — List test scenarios for an agent.
- `invarium_create_scenario` — Create a new test scenario for an agent.
- `invarium_manage_scenario` — Manage a scenario: update its fields, delete it, or toggle its active state.
- `invarium_sync_results` — Sync test results from your IDE to the Invarium dashboard.
- `invarium_list_test_runs` — List test runs for an agent or across all agents.
- `invarium_get_test_run` — Get detailed test run results including individual test case outcomes.
- `invarium_get_audit` — Retrieve the latest static audit results for your agent.
- `invarium_get_agent` — Get detailed information about a specific agent.
- `invarium_delete_agent` — Delete an agent and all its associated data from Invarium.
- `invarium_dashboard` — Show the Invarium dashboard overview.
- `invarium_usage` — Show your current plan usage and remaining limits.
- `invarium_setup_tracing` — Install or update the Invarium tracer library in .invarium/.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get invarium-ai/invarium <tool-name>
```

## Resources

- `invarium://templates/agent-blueprint` — Agent blueprint YAML template. Use this to understand the structure
- `invarium://templates/blueprint-prompt` — Prompt template for generating agent blueprints. Read this prompt, then
- `invarium://templates/trace-library` — Behavioral tracer for capturing tool calls during test execution.
- `invarium://templates/trace-prompt` — Step-by-step guide for running behavioral test cases with tracing.