Audryo

Audryo agent toolkit

Let your AI agent run your lifecycle email: audiences, journeys, campaigns, emails and transactional sends in Audryo, through the same API the app uses. Your agent does the setup work; nothing reaches a customer until a person approves it.

This repo ships the audryo CLI, an MCP server and agent skills for Claude Code, Codex, Cursor and any other MCP client.

You:   Set up an onboarding journey for signups who haven't created a
       project after 3 days.

Agent: Reads your data schema, builds the audience, drafts a three-email
       journey, dry-runs it and fast-forwards it in the sandbox. Then it
       hands back what to review. Nothing has been sent.

Safety model

• Drafts by default. Journeys, emails and campaigns an agent creates are review-only proposals.
• Sending needs deliver. Without that scope a key cannot activate a journey or send anything, even by mistake. With it, Audryo still requires a passing dry run and confirmed emails.
• Sandbox first. New projects capture every email in a sandbox inbox, so agents can test real journeys end to end. Going live is a human decision in the app.
• Retry-safe. Sends and proposals take an Idempotency-Key, so a retried call never sends twice.
• No inferred consent. Ingesting contacts never grants marketing consent.

Quick start

1. Sign up (free during the public beta) and create a project. It starts in the sandbox.
2. Create an API key under Settings → Developer with the smallest scope that works (see Configuration).
3. Connect your agent:

Claude Code (plugin: MCP server + skills)

export AUDRYO_API_KEY="sf_live_..."
claude plugin marketplace add Audryo/agent-toolkit
claude plugin install audryo@audryo

Any agent: skills only

npx skills add Audryo/agent-toolkit

Any MCP client

{
  "mcpServers": {
    "audryo": {
      "command": "npx",
      "args": ["-y", "audryo", "mcp"],
      "env": {
        "AUDRYO_API_KEY": "sf_live_...",
        "AUDRYO_PROJECT_ID": "<project-uuid>"
      }
    }
  }
}

Codex: codex mcp add audryo --env AUDRYO_API_KEY=sf_live_... -- npx -y audryo mcp

Configuration

Variable	Required	Default
AUDRYO_API_KEY	yes	—
AUDRYO_PROJECT_ID	for project tools	list with npx audryo bootstrap
AUDRYO_API_BASE	no	https://api.audryo.com/v1

Give agents the smallest key that works:

Task	Scopes
Inspect	read
Sync data, draft journeys, emails and campaigns	read, write
Activate journeys, send campaigns and transactional email	read, write, deliver

MCP tools

Area	Tools	Scope
Orient	get_manifest, get_bootstrap, get_setup_context, get_brief, get_plan_usage	read
Product and data	get_product_context, get_data_context, list_contacts, ingest_contacts, ingest_events	read / write
Audiences	list_audiences, get_audience, preview_audience, create_audience, update_audience, delete_audience, suggest_audiences	read / write
Journeys	list_journeys, inspect_journey, create_journey_proposal, revise_journey, propose_from_finding, run_dry_run	read / write
Emails	create_email, create_journey_email	write
Campaigns	list_campaigns, draft_campaign	read / write
Sandbox	get_delivery_mode, list_sandbox_messages, get_sandbox_message, fast_forward_journey	read / write
Insights	get_delivery_health, get_performance, get_observation, run_observation, get_copilot_plan	read
Go live	activate_journey, pause_journey, send_campaign, send_transactional	deliver

Every tool is also a CLI command.

CLI

npx audryo bootstrap
npx audryo contacts ingest contacts.json
npx audryo events ingest events.json
npx audryo journeys list
npx audryo journeys inspect <workflowId>
npx audryo audiences create --name "All contacts" --definition '{"operator":"and","conditions":[]}'
npx audryo campaigns draft --name "July update" --audience-id <id> --subject "What's new"
npx audryo delivery health

Skills

Skill	Teaches the agent to
audryo-api	Connect, pick scopes, use MCP or CLI instead of curl, stop at review
audryo-email	Build valid email documents, handle locales, save drafts for review
audryo-sending	Choose communication classes, respect consent, protect deliverability

Full guide: https://app.audryo.com/docs/agents/quickstart

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md and the changelog. Report security issues privately: SECURITY.md.

License: MIT