Skip to main content
Glama
Audryo

Audryo

by Audryo

Audryo agent toolkit

npm CI License: MIT Listed on mcpservers.org

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.

Related MCP server: Pushizo MCP Server

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to read and manage contacts, lists, tags, events, templates, campaigns and message logs in an Arsel organization, and to draft email, SMS, push and in-app campaigns for review. It is read-and-draft only, so agents can create and update records but cannot send, schedule or delete anything.
      96
      18 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Lets AI clients read segments, campaigns, messages, templates, and analytics and create draft campaigns and segments with explicit approval, without send, schedule, or delete tools.
      478 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to run a SaaS app's admin through a scoped, audited API — looking up users, applying support actions, reading growth and retention, building segments, toggling feature flags and drafting emails in plain language. Access is limited by key scopes, so tools outside a key's permissions never appear.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI apps to create and edit campaigns, ad groups, and ads, upload videos and images, and read spend and performance metrics, while saving every change as a draft for approval before publishing.
      5
      MIT