Test your voice agent in one line of code

from noveum_trace.testing import VoiceTester

tester = VoiceTester(api_key="...")

def test_cancellation_flow():
    result = tester.call(
        endpoint={"type": "phone", "phoneNumber": "+14155551234", "phoneCountryCode": "+1"},
        persona={"name": "Frustrated customer", "goal": "Cancel subscription"},
        scenario={"name": "Cancellation", "description": "Caller insists on canceling"},
    ).wait()
    assert result.passed, result.eval.summary
    print("Recording:", result.recording_url)

curl -sS -X POST https://api.noveum.ai/api/v1/developer/calls \
  -H "Authorization: Bearer $NOVEUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": {"type":"livekit","livekitUrl":"...","livekitApiKey":"...",
                 "livekitApiSecret":"...","livekitAgentName":"booking-agent"},
    "persona": {"name":"New customer","goal":"Book a table for 4"},
    "scenario": {"name":"Booking","description":"Restaurant reservation"},
    "eval": true
  }'

# In Claude / Cursor with the Noveum MCP server configured:
> Test my voice agent at +14155551234 — try to cancel a subscription.

# Claude reads noveum://developer-calls-playbook, runs the call,
# polls for results, and shows the transcript + eval score.