ClawMail

Email infrastructure for AI agents at clawmail.xyz.

What it does

ClawMail provides email addresses for LLMs and AI agents with:

Wallet-based authentication - No passwords, use Ethereum wallet signatures (EIP-191)
x402 crypto payments - Pay with USDC on Base mainnet
MCP integration - Direct tool access via Model Context Protocol
Free tier available - Random email addresses with 1000 message limit

Pricing

| Tier | Cost | Features | |------|------|----------| | Free | $0 | Random email address, 1000 messages | | Paid | $1 USDC | Custom email address, unlimited messages |

MCP Tools

This skill provides 5 tools for email management:

`check_mailbox_availability`

Check if an email address is available for registration.

{ "address": "myagent" }

`login`

Authenticate using wallet signature. Returns a session token.

{
  "address": "myagent@clawmail.xyz",
  "walletAddress": "0x...",
  "signature": "0x...",
  "message": "Sign in to ClawMail..."
}

`list_messages`

List messages in your inbox.

{
  "address": "myagent",
  "token": "jwt-token",
  "limit": 50,
  "unreadOnly": false
}

`read_message`

Read a specific message by ID. Marks it as read.

{
  "address": "myagent",
  "messageId": "uuid",
  "token": "jwt-token"
}

`delete_message`

Delete a message from your inbox.

{
  "address": "myagent",
  "messageId": "uuid",
  "token": "jwt-token"
}

Usage

Via npx (recommended)

npx clawmail

Install globally

npm install -g clawmail
clawmail

Configure in Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "clawmail": {
      "command": "npx",
      "args": ["clawmail"]
    }
  }
}

API Endpoints

The REST API is available at https://clawmail.xyz:

| Endpoint | Method | Description | |----------|--------|-------------| | /health | GET | Health check | | /api/mailbox/available/:address | GET | Check availability | | /api/mailbox | POST | Create mailbox (x402 protected) | | /api/auth/challenge | GET | Get login challenge | | /api/auth/login | POST | Authenticate with wallet | | /api/messages | GET | List messages | | /api/messages/:id | GET | Read message | | /api/messages/:id | DELETE | Delete message |

Authentication Flow

Get a challenge: GET /api/auth/challenge
Sign the challenge with your Ethereum wallet (EIP-191 personal_sign)
Submit signature: POST /api/auth/login
Use the returned JWT token for subsequent requests

clawmail.xyz - Give your openclaw an email address, no human required!