Getting Started¶

Get Assay running in 5 minutes.

Overview¶

This guide covers:

1. Installation — Install the Assay CLI
2. Quick Start — Import a trace and run your first test
3. Your First Test — Write a custom policy from scratch
4. CI Integration — Add Assay to GitHub Actions / GitLab CI

Prerequisites¶

• Rust 1.70+ or Python 3.9+
• An MCP session log (or use our example)
• 5 minutes ☕

The 60-Second Version¶

# Install
pip install assay

# Import an MCP session (creates config automatically)
assay import --format mcp-inspector session.json --init

# Run tests
assay run --config mcp-eval.yaml

# Add to CI
# Copy the GitHub Action from ci-integration.md

That's it. Your AI agent now has zero-flake regression tests.

What You'll Learn¶

By the end of this guide, you'll understand:

Next Steps¶