email

Name: email
Author: merit-systems

github.com/merit-systemsProductivity23142 installsUpdated 10w ago

About email

email is a skill for sending email and managing inboxes through StableEmail. It supports shared sending, paid inboxes, and custom subdomains, with APIs for forwarding and programmatic message access.

Key features

01Send email with text, HTML, and attachments
02Buy and manage forwarding inboxes
03Retain, list, read, and delete messages
04Send from custom subdomains
05Create subdomain inboxes and catch-all forwarding

Use cases

01Send transactional emails from an application
02Receive email in a programmatically accessible inbox
03Set up team addresses on a custom subdomain

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/merit-systems/agentcash-skills --skill email

After installing, type/emailin Claude Code to confirm it loaded.

Bundled filesrules/getting-started.md

Details

From the project README

Email with StableEmail

Send emails, manage inboxes, and run custom subdomains via x402 payments at https://stableemail.dev.

Setup

See rules/getting-started.md for installation and wallet setup.

Quick Reference

Task	Endpoint	Price
Send email (shared)	`https://stableemail.dev/api/send`	$0.02
Buy subdomain	`https://stableemail.dev/api/subdomain/buy`	$5.00
Send from subdomain	`https://stableemail.dev/api/subdomain/send`	$0.005
Buy inbox	`https://stableemail.dev/api/inbox/buy`	$1.00
Send from inbox	`https://stableemail.dev/api/inbox/send`	$0.005
Top up inbox (30d)	`https://stableemail.dev/api/inbox/topup`	$1.00
Top up inbox (90d)	`https://stableemail.dev/api/inbox/topup/quarter`	$2.50
Top up inbox (365d)	`https://stableemail.dev/api/inbox/topup/year`	$8.00
List inbox messages	`https://stableemail.dev/api/inbox/messages`	$0.001
Read inbox message	`https://stableemail.dev/api/inbox/messages/read`	$0.001
Create subdomain inbox	`https://stableemail.dev/api/subdomain/inbox/create`	$0.25
List subdomain messages	`https://stableemail.dev/api/subdomain/inbox/messages`	$0.001
Read subdomain message	`https://stableemail.dev/api/subdomain/inbox/messages/read`	$0.001

Free Management Endpoints

Task	Endpoint
Subdomain status	`GET https://stableemail.dev/api/subdomain/status?subdomain=name`
Update subdomain	`POST https://stableemail.dev/api/subdomain/update`
Manage signers	`POST https://stableemail.dev/api/subdomain/signers`
Inbox status	`GET https://stableemail.dev/api/inbox/status?username=name`
List your inboxes	`POST https://stableemail.dev/api/inbox/list`
Update inbox	`POST https://stableemail.dev/api/inbox/update`
Cancel inbox	`POST https://stableemail.dev/api/inbox/cancel`
Delete message	`POST https://stableemail.dev/api/inbox/messages/delete`
List subdomain inboxes	`POST https://stableemail.dev/api/subdomain/inbox/list`
Delete subdomain inbox	`POST https://stableemail.dev/api/subdomain/inbox/delete`
Update subdomain inbox	`POST https://stableemail.dev/api/subdomain/inbox/update`
Delete subdomain message	`POST https://stableemail.dev/api/subdomain/inbox/messages/delete`

Free endpoints use SIWX wallet authentication (handled automatically by npx agentcash@latest fetch).

Send an Email

Send from the shared [email protected] address:

npx agentcash@latest fetch https://stableemail.dev/api/send -m POST -b '{
  "to": ["[email protected]"],
  "subject": "Hello from x402",
  "html": "<h1>Hi!</h1><p>This email was sent via x402 payments.</p>",
  "text": "Hi! This email was sent via x402 payments.",
  "replyTo": "[email protected]"
}'

Parameters:

to — array of recipient emails (required)
subject — email subject (required)
html and/or text — email body (at least one required)
replyTo — reply-to address (optional but recommended)
attachments — array of {content, contentType, filename} (optional, max 5, base64 encoded, ~3.75MB limit each)

Attachment example:

{
  "attachments": [{
    "content": "base64-encoded-content...",
    "contentType": "application/pdf",
    "filename": "report.pdf"
  }]
}

For calendar invites, use contentType: "text/calendar; method=REQUEST".

Forwarding Inbox

Buy [email protected] for $1/month. Emails are forwarded to your real address and/or retained for programmatic access.

Buy an Inbox

npx agentcash@latest fetch https://stableemail.dev/api/inbox/buy -m POST -b '{
  "username": "alice",
  "forwardTo": "[email protected]"
}'

Omit forwardTo to use as a programmatic-only mailbox (retainMessages auto-enabled).

Send from Inbox

npx agentcash@latest fetch https://stableemail.dev/api/inbox/send -m POST -b '{
  "username": "alice",
  "to": ["[email protected]"],
  "subject": "Hello",
  "html": "<p>Hi Bob</p>",
  "text": "Hi Bob"
}'

Top Up Inbox

npx agentcash@latest fetch https://stableemail.dev/api/inbox/topup -m POST -b '{"username": "alice"}'

Anyone can top up any inbox. Top-ups stack. Bulk discounts: 90 days/$2.50 (17% off), 365 days/$8 (34% off).

Cancel and Refund

npx agentcash@latest fetch https://stableemail.dev/api/inbox/cancel -m POST -b '{"username": "alice"}'

Returns pro-rata USDC refund on-chain automatically.

Read Inbox Messages

Enable message retention, then read messages programmatically.

Enable Retention

npx agentcash@latest fetch https://stableemail.dev/api/inbox/update -m POST -b '{"username": "alice", "retainMessages": true}'

List Messages

npx agentcash@latest fetch https://stableemail.dev/api/inbox/messages -m POST -b '{"username": "alice", "limit": 20}'

Read a Message

npx agentcash@latest fetch https://stableemail.dev/api/inbox/messages/read -m POST -b '{"messageId": "msg_abc123"}'

Returns full message with from, to, subject, date, text, html, and attachment download URLs (URLs expire after 1 hour). Message content and attachments are retained for 90 days.

Custom Subdomains

Buy yourname.stableemail.dev for $5 one-time. Send from any address on your subdomain for $0.005/email.

Buy a Subdomain

npx agentcash@latest fetch https://stableemail.dev/api/subdomain/buy -m POST -b '{"subdomain": "yourname"}'

Rules: 3-30 chars, lowercase alphanumeric + hyphens. DNS verification takes ~5 minutes.

Send from Subdomain

npx agentcash@latest fetch https://stableemail.dev/api/subdomain/send -m POST -b '{
  "from": "[email protected]",
  "to": ["[email protected]"],
  "subject": "Your order confirmation",
  "html": "<p>Thank you for your order!</p>"
}'

Create Subdomain Inboxes

Create per-address inboxes on your subdomain ($0.25 each, max 100 inboxes, 500 messages each):

npx agentcash@latest fetch https://stableemail.dev/api/subdomain/inbox/create -m POST -b '{
  "subdomain": "yourname",
  "localPart": "support",
  "forwardTo": "[email protected]"
}'

Catch-All Forwarding

Forward all unmatched addresses on your subdomain:

npx agentcash@latest fetch https://stableemail.dev/api/subdomain/update -m POST -b '{"subdomain": "yourname", "catchAllForwardTo": "[email protected]"}'

Manage Authorized Signers

Allow other wallets to send from your subdomain:

npx agentcash@latest fetch https://stableemail.dev/api/subdomain/signers -m POST -b '{"action": "add", "subdomain": "yourname", "walletAddress": "0x..."}'

Images in Emails

Host images on StableUpload or AgentUpload, then reference in HTML:

<img src="https://f.stableupload.dev/abc/photo.png" alt="Photo" />

Most email clients strip data URIs — always use hosted URLs.

Workflows

Quick Send

(Optional) Check balance: npx agentcash@latest balance
Send email via /api/send
Confirm delivery via messageId

Set Up Professional Email

Buy subdomain ($5)
Wait for DNS verification (~5 min)
Create inboxes for team members ($0.25 each)
Set up catch-all forwarding
Send from custom addresses ($0.005 each)

Programmatic Mailbox

Buy inbox with no forwardTo ($1)
Messages are retained automatically (90 days)
List and read messages via API ($0.001 each)
Delete messages when processed (free)

Cost Estimation

Task	Cost
Send one email (shared)	$0.02
Send one email (subdomain/inbox)	$0.005
Buy inbox (30 days)	$1.00
Buy inbox (1 year)	$1.00 + $8.00 = $9.00
Buy subdomain + 5 inboxes	$5.00 + $1.25 = $6.25
Read 100 messages	$0.10

Comments

Markdown supported

Details

Author: merit-systems
Repository: merit-systems/agentcash-skills
Category: Productivity
Installs: 142
GitHub stars: 23

Report

More skills

All skills

lark-base

open.feishu.cn

823.2k

Operate on Feishu Base: create tables, fields, records, and views; handle statistics, formulas/lookups, forms, dashboards, app mode (BaseApp/AppMode pages and components), Workspace directories, workflows, role permissions, and the template center (Base template categories, lists, and search). Use when encountering Base/multidimensional tables/bitable, BaseApp/AppMode, or /base/ or /app/ links. Do not use lark-apps for BaseApp; route file import/export to lark-drive and authentication/authorization to lark-shared.

lark-drive

open.feishu.cn

823.2k

Feishu cloud storage (Drive): manage Drive files and folders, including uploads/downloads, folder creation, copying/moving/deleting, viewing metadata, checking permission settings, comments/permissions/subscriptions, titles, versions, Feishu document security labels (secure labels), and local file imports. Use when users need to organize Drive folders, handle cloud storage resource URLs/tokens, identify link types/actual tokens/titles, or import Word/Markdown/Excel/CSV/PPTX/.base as docx/sheet/bitable/slides. Route doubao.com cloud storage URLs/tokens by resource path and token too; do not fall back to WebFetch. Not responsible for: editing document content (use lark-doc), spreadsheet/Base table data operations (use lark-sheets/lark-base), knowledge space node/member management (use lark-wiki), or native Markdown file read/write/patch/diff (use lark-markdown).

lark-shared

open.feishu.cn

822.9k

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling _notice JSON.

lark-im

open.feishu.cn

822.3k

Feishu instant messaging: send and receive messages and manage group chats. Send and reply to messages, search chat history, manage group members, upload and download images and files, manage emoji reactions, send urgent notifications in-app/by SMS/by phone, send and handle Interactive Cards, and listen for card button callbacks (card.action.trigger). Use when users need to send messages, view or search chat history, download chat files, view group members, search groups, create group or topic chats, manage marker data, manage Feed pins (add/remove/search pinned conversations), manage tag data, or handle card callbacks.