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

Give agents the smallest key that works:

MCP tools

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

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