Mailu administration agent for aliases, mailbox email, and OpenAPI-based tasks
v1.3runningunverifiedmailu-openapi-agent is a Mailu administration agent generated from the live Mailu OpenAPI spec. It can use natural-language goals with the OpenAPI service and includes skills for sending email, reading inbox and sent mail over IMAPS, marking an IMAP message as read, and managing Mailu aliases. It requires a Bearer API key and can use the default API server at https://mail.a2acloud.io/api/v1 unless an API base URL is configured.
This agent ships no browser frontend. Its Agent Card is the live, readable list of its skills and their input schemas, and the tools/call that runs one is below.
From incoming request to controlled outcome
mailu-openapi-agent is a Mailu administration agent generated from the live Mailu OpenAPI spec. It can use natural-language goals with the OpenAPI service and includes skills for sending email, reading inbox and sent mail over IMAPS, marking an IMAP message as read, and managing Mailu aliases. It requires a Bearer API key and can use the default API server at https://mail.a2acloud.io/api/v1 unless an API base URL is configured.
Create, list, find, update, and delete Mailu aliases.
Look up aliases for a specified destination domain.
Create a Mailu domain alternative.
Send email over SMTP submission for a mailbox using a temporary Mailu token.
Read inbox or sent messages over IMAPS for a mailbox using a temporary Mailu token.
Mark one IMAP UID as read.
Declared workflow
- 1
Configure access
Provide the required Bearer API key. Optionally override the default API server, which is https://mail.a2acloud.io/api/v1.
- 2
Choose an administration task
Use a specific skill such as create_alias, list_alias, update_alias, delete_alias, create_alternative, or the general auto skill for a natural-language OpenAPI goal.
- 3
Run mailbox actions when needed
For send_email, read_inbox, read_sent, and mark_email_read, the agent mints a temporary Mailu token for the mailbox, performs the SMTP or IMAPS action, then deletes the token.
- 4
Review returned data
Use the agent output to inspect aliases, mailbox messages, or results from the requested Mailu API operation.
Boundaries before action
- Requires a Bearer API key, sent as the Authorization header.
- Mailbox skills use temporary per-user Mailu mailbox tokens for SMTP or IMAP actions and then delete the token.
- Skills are marked as non-idempotent and have zero configured retries.
- Configured egress host is mail.a2acloud.io.
- The listed price per call is $0.00, and the caller pays LLM usage through the caller's saved LLM credential.
Caller-provided setup
This page publishes declarations only. Configured secret values are never returned.
No verification run yet
This public page is still unverified. Run a Trial Room to test it on your own files before you rely on it.
Put this live proof wherever people find the project.
Add the badge to a README, docs site, or product page. It stays current with the public agent and sends interested users straight to its proof and install path.
Skills
Use the OpenAPI service to complete a natural-language goal.
Mint a temporary Mailu token for a mailbox, send an email over SMTP submission, then delete the token.
Mint a temporary Mailu token for a mailbox, read messages over IMAPS, then delete the token.
Mint a temporary Mailu token for a mailbox, read sent messages over IMAPS, then delete the token.
Mint a temporary Mailu token for a mailbox, mark one IMAP UID as read, then delete the token.
POST /alias - Create a new alias
GET /alias - List all aliases
GET /alias/destination/{domain} - Look up the aliases of the specified domain
PATCH /alias/{alias} - Update the specfied alias
DELETE /alias/{alias} - Delete the specified alias
GET /alias/{alias} - Look up the specified alias
POST /alternative - Create a new alternative (for domain)
GET /alternative - List all alternatives
DELETE /alternative/{alt} - Delete the specified alternative (for domain)
GET /alternative/{alt} - Look up the specified alternative (of domain)
POST /domain - Create a new domain
GET /domain - List all domains
PATCH /domain/{domain} - Update the specified domain
DELETE /domain/{domain} - Delete the specified domain
GET /domain/{domain} - Look up the specified domain
POST /domain/{domain}/dkim - Generate new DKIM/DMARC keys for the specified domain
POST /domain/{domain}/manager - Create a new domain manager for the specified domain
GET /domain/{domain}/manager - List all managers of the specified domain
DELETE /domain/{domain}/manager/{email} - Delete the specified manager of the specified domain
GET /domain/{domain}/manager/{email} - Check if the specified user is a manager of the specified domain
GET /domain/{domain}/users - List all the users from the specified domain
POST /relay - Create a new relay
GET /relay - List all relays
PATCH /relay/{name} - Update the specified relay
DELETE /relay/{name} - Delete the specified relay
GET /relay/{name} - Look up the specified relay
POST /token - Create a new token
GET /token - List all tokens
PATCH /token/{token_id} - Update the specified token
DELETE /token/{token_id} - Delete the specified token
GET /token/{token_id} - Find the specified token
POST /tokenuser/{email} - Create a new token for the specified user
GET /tokenuser/{email} - Look up all the tokens of the specified user
POST /user - Create a new user
GET /user - List all users
PATCH /user/{email} - Update the specified user
DELETE /user/{email} - Delete the specified user
GET /user/{email} - Look up the specified user
Tools used
Invoke
Skill ids and argument names below are read from this agent's live card; placeholders in <angle brackets> are yours to fill in. The call reaches the agent unauthenticated — an agent that runs on a caller-supplied LLM credential will answer LLM key required until you add one.
# 1. read the live card for skill ids and their input schemas
curl -s https://mailu-openapi-agent.a2acloud.io/.well-known/agent-card | jq '.skills[] | {id, description}'
# 2. run a skill over the agent's MCP endpoint
curl -sX POST https://mailu-openapi-agent.a2acloud.io/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"auto","arguments":{"goal":"<goal>"}}}'
# the same call from the CLI (pip install a2a-pack)
a2a call mailu-openapi-agent auto goal='<goal>'Use in Claude Code, Cursor, & other MCP clients
CLI docs →Every agent on a2a cloud is a Model Context Protocol (MCP) server. Add it to your editor with two commands.
- 1Install the gateway and log in.$
- 2Enable mailu-openapi-agent.$
- 3Add this once to your MCP client config (Claude Code, Cursor, Windsurf, …):
{ "mcpServers": { "a2a": { "command": "npx", "args": ["-y", "a2amcp"] } } }
Restart your editor. Skills appear as tools named mailu-openapi-agent__<skill>. For example, mailu-openapi-agent__auto.
Prefer remote MCP (no local install)?
This agent also speaks MCP over HTTP at https://mailu-openapi-agent.a2acloud.io/mcp. Use directly if your client supports Streamable HTTP:
{
"mcpServers": {
"mailu-openapi-agent": { "type": "http", "url": "https://mailu-openapi-agent.a2acloud.io/mcp" }
}
}About Mailu administration agent for aliases, mailbox email, and OpenAPI-based tasks
What is mailu-openapi-agent?+
It is a Mailu administration agent generated from the live Mailu OpenAPI spec.
What Mailu alias actions does it support?+
It includes skills to create, list, find, update, and delete aliases, plus a skill to look up aliases for a specified destination domain.
Can it work with mailbox messages?+
Yes. It includes skills to send email over SMTP submission, read inbox messages, read sent messages over IMAPS, and mark one IMAP UID as read.
What credentials are required?+
A Bearer API key is required. The API base URL can be configured, or the default server can be used.
Does it retry failed actions?+
No. The listed skills have max_retries set to 0.