mailerastro_send_email
Send a single transactional email through MailerAstro. Payment is automatic via your wallet's USDC balance on Base (x402 protocol).
Pricing:
- Plain text: $0.001 per email
- HTML: $0.005 per email
Your wallet address IS your identity — no API keys or accounts needed. First-time senders are automatically registered.
Args:
- wallet_address (string): Your 0x... Ethereum/Base wallet address
- to (string): Recipient email address
- from (string): Sender email address
- from_name (string, optional): Display name for sender
- subject (string): Email subject line
- body (string): Email body (plain text or HTML)
- content_type ('text' | 'html'): Content format (default: 'text')
- reply_to (string, optional): Reply-to email address
Returns:
JSON with: success (boolean), messageId (string), cost (number), remainingBalance (number)
Examples:
- Send a welcome email: wallet_address="0x...", to="
[email protected]", from="
[email protected]", subject="Welcome!", body="Thanks for signing up."
- Send HTML email: same as above but content_type="html", body="<h1>Welcome!</h1>"
Error Handling:
- 402: Insufficient USDC balance. Fund your wallet on Base.
- 429: Rate limited. Max 60 emails/minute.
- Use mailerastro_check_balance to verify funds before sending.
mailerastro_send_batch
Send up to 50 transactional emails in a single call. More efficient than individual sends — includes a 10% batch discount.
Pricing (with batch discount):
- Plain text: $0.0009 per email
- HTML: $0.005 per email
Args:
- wallet_address (string): Your 0x... wallet address
- recipients (array): Up to 50 objects with { email, name? }
- from (string): Sender email address
- from_name (string, optional): Sender display name
- subject (string): Email subject line
- body (string): Email body content
- content_type ('text' | 'html'): Content format (default: 'text')
- reply_to (string, optional): Reply-to address
Returns:
JSON with: success, totalSent, totalFailed, results (per-recipient), totalCost, remainingBalance
Examples:
- Notify 20 users: wallet_address="0x...", recipients=[{email: "
[email protected]"}, ...], from="
[email protected]", subject="Update", body="New feature launched"
Error Handling:
- 402: Insufficient balance for entire batch. Partial sends are not performed.
- Maximum 50 recipients per batch call.
mailerastro_check_balance
Check your USDC balance on MailerAstro. This is FREE — no payment required.
Use this before sending emails to verify you have sufficient funds. Your wallet address is your identity on MailerAstro.
Args:
- wallet_address (string): Your 0x... Ethereum/Base wallet address
- response_format ('json' | 'markdown'): Output format (default: 'json')
Returns:
JSON with: walletAddress, balance (in USD), currency, lastUpdated
Examples:
- Check balance: wallet_address="0x1234...abcd"
- A balance of $1.00 can send ~1,000 plain text emails or ~200 HTML emails
Error Handling:
- 404: Wallet not found. Send your first email to auto-register, or fund your wallet with USDC on Base.
mailerastro_get_reputation
Query the reputation score and tier for any wallet address. This is FREE — no payment required.
MailerAstro tracks agent reputation based on email behavior. Higher reputation unlocks premium services and higher rate limits.
Tiers: Bronze (0-25) → Silver (26-50) → Gold (51-75) → Platinum (76-100)
Args:
- wallet_address (string): Wallet address to query (can be any agent's address)
- response_format ('json' | 'markdown'): Output format (default: 'json')
Returns:
JSON with: walletAddress, score (0-100), tier, totalEmailsSent, deliveryRate, bounceRate, spamRate, lastUpdated
Examples:
- Check your own reputation: wallet_address="0x1234...abcd"
- Check another agent's reputation before interacting: wallet_address="0xabcd...1234"
- Platinum tier agents get priority delivery and higher rate limits
Error Handling:
- 404: Wallet has no reputation history. Score starts at 50 (Silver) after first email.
mailerastro_get_send_history
View recent email send history for your wallet, including delivery status. This is FREE — no payment required.
Use this to monitor deliverability, track bounces, and debug issues. Supports pagination and status filtering.
Args:
- wallet_address (string): Your 0x... wallet address
- limit (number): Max results per page (1-100, default: 20)
- offset (number): Skip N results for pagination (default: 0)
- status ('delivered' | 'bounced' | 'pending' | 'failed', optional): Filter by status
- response_format ('json' | 'markdown'): Output format (default: 'json')
Returns:
JSON with: total, count, offset, entries[], has_more, next_offset
Examples:
- Get last 10 sends: wallet_address="0x...", limit=10
- Check for bounces: wallet_address="0x...", status="bounced"
- Page through history: offset=20, limit=20 (page 2)
Error Handling:
- 404: No history found for this wallet.
mailerastro_get_started
Get setup instructions and introduction to MailerAstro — the email API for AI agents.
Call this first to understand how MailerAstro works. Optionally provide your wallet address to check if you already have a balance.
This tool is FREE — no payment required.
Args:
- wallet_address (string, optional): Your 0x... wallet to check existing balance
Returns:
Setup guide with pricing, capabilities, and next steps. If wallet_address provided, includes current balance.
Examples:
- First time: mailerastro_get_started with no args
- Returning agent: mailerastro_get_started with wallet_address="0x..."