Mailerastro

Name: Mailerastro
Author: ruthlesscodes

@ruthlesscodes

Repository

About Mailerastro

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mailerastro": {
      "url": "https://mcp.mailerastro.com/mcp"
    }
  }
}

Tools

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.

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.

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.

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.

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.

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..."

Overview

What is Mailerastro?

Mailerastro is an MCP server that lets AI agents send transactional emails, check wallet balances, and query reputation scores. Payments are made with USDC on Base via the x402 protocol. No API keys, accounts, or subscriptions are required—just a wallet address. It is designed for developers building agent-based email workflows.

How to use Mailerastro?

Connect any MCP-compatible client to the hosted server at https://mcp.mailerastro.com/mcp (Streamable HTTP) or run locally with npx mailerastro-mcp-server. Tools include mailerastro_send_email, mailerastro_send_batch, mailerastro_check_balance, and mailerastro_get_reputation. Configure the MAILERASTRO_API_URL environment variable if needed. For local use with Claude Desktop, add the server to claude_desktop_config.json.

Key features of Mailerastro

Pay per email with USDC on Base via x402 protocol
No API keys, accounts, or sign‑up required
Reputation system with Bronze, Silver, Gold, Platinum tiers
Batch sending of up to 50 emails with a 10% discount
Wallet address serves as identity
Free tools for onboarding, balance check, and reputation query

Use cases of Mailerastro

AI agents send transactional emails (e.g., order confirmations, password resets)
Automated batch email campaigns with per‑email USDC payment
Monitoring agent email budget with real‑time balance checks
Building sender reputation through consistent, high‑quality email activity
No‑friction onboarding for new agents – account created on first use

FAQ from Mailerastro

What does Mailerastro do that email APIs don’t?

It eliminates API keys and subscriptions entirely. Payment happens per email via your crypto wallet, and an agent’s identity is its wallet address. A reputation system rewards consistent sending.

Do I need an API key or account to use Mailerastro?

No. Your wallet address is your identity. The server creates an account automatically on the first use. No sign‑up or API key is required.

What runtime or environment does Mailerastro require?

Node.js. The server can run locally (stdio) or as a remote HTTP service. Self‑hosting is supported on platforms like Railway.

How are payments handled?

Each email payment is deducted from your USDC wallet balance on Base via the x402 protocol. Plain text emails cost $0.001 each; HTML costs $0.005. Batch sends receive a 10% discount.

Where does my email data live?

Email data is handled by the MailerAstro API backend. The MCP server itself is a thin proxy; delivery history and reputation data reside on the API servers.