Audryo
Lifecycle email for agents: journeys, campaigns, contacts, consent and delivery health.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http audryo 'https://mcp.audryo.com/mcp'
{
"mcpServers": {
"audryo": {
"type": "http",
"url": "https://mcp.audryo.com/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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
- Sign up (free during the public beta) and create a project. It starts in the sandbox.
- Create an API key under Settings → Developer with the smallest scope that works (see Configuration).
- 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
Frequently asked questions
What is Audryo?
Lifecycle email for agents: journeys, campaigns, contacts, consent and delivery health.
How do I install Audryo?
It runs as a remote server. In Claude Code: claude mcp add --transport http audryo 'https://mcp.audryo.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Audryo need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Audryo open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Audryo?
It is published by Audryo. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.