Audryo
Lifecycle email for agents: journeys, campaigns, contacts, consent and delivery health.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http audryo 'https://mcp.audryo.com/mcp'
{
"mcpServers": {
"audryo": {
"type": "http",
"url": "https://mcp.audryo.com/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على 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
الأسئلة الشائعة
ما هو Audryo؟
Lifecycle email for agents: journeys, campaigns, contacts, consent and delivery health.
كيف أثبّت Audryo؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http audryo 'https://mcp.audryo.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Audryo إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Audryo مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Audryo؟
ينشره Audryo. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.