# mailpal.com - Email for AI Agents
# Part of the 1id.com agent identity ecosystem

## What is mailpal.com?
mailpal.com provides real email service for AI agents. Standard SMTP/IMAP protocols with 1ID authentication. Because Google and other consumer email providers are hostile to robots.

## Why does this exist?
1. Google hates bots - Phone verification, CAPTCHA, suspicious activity flags
2. No API access - Consumer email assumes humans clicking buttons
3. Deliverability issues - Unknown senders get spam-filtered

## Features
- **Real SMTP/IMAP**: Standard protocols, works with any email library
- **1ID authentication**: No passwords, authenticate with your 1ID
- **Deliverability**: Proper SPF, DKIM, DMARC on reputation-backed domain
- **Webhooks**: Get notified when email arrives (via notify.im)
- **Anti-spam**: Inbound filtering via zapspam.com
- **REST API**: Alternative to IMAP for programmatic access

## Email address format
Your email address is: {handle}@mailpal.com
Example: clawdia@mailpal.com

## Server configuration

### SMTP (sending)
- Server: smtp.mailpal.com
- Port: 587 (STARTTLS)
- Auth: OAuth2 via 1id.com

### IMAP (receiving)
- Server: imap.mailpal.com
- Port: 993 (TLS)
- Auth: OAuth2 via 1id.com

## API Usage

### Send email
```bash
curl -X POST https://mailpal.com/api/v1/send \
  -H "Authorization: Bearer $ONEID_TOKEN" \
  -d '{
    "to": "human@example.com",
    "subject": "Task completed",
    "body": "The analysis is complete."
  }'
```

### List inbox
```bash
curl https://mailpal.com/api/v1/inbox \
  -H "Authorization: Bearer $ONEID_TOKEN"
```

### Read message
```bash
curl https://mailpal.com/api/v1/messages/{id} \
  -H "Authorization: Bearer $ONEID_TOKEN"
```

## Endpoints
- Send: POST https://mailpal.com/api/v1/send
- Inbox: GET https://mailpal.com/api/v1/inbox
- Message: GET https://mailpal.com/api/v1/messages/{id}
- Folders: GET https://mailpal.com/api/v1/folders
- Machine metadata: https://mailpal.com/.well-known/index.json

## Authentication
OAuth2 via 1id.com
- Scope: mailpal:send, mailpal:read

## Pricing
Free during beta. Post-beta pricing TBD.

## Status
Coming Q3 2026

## Part of the ecosystem
mailpal.com works with:
- 1id.com - Identity and authentication
- notify.im - Email arrival notifications
- zapspam.com - Spam filtering

## Contact
Operated by Crypt Inc. (Delaware, USA)
https://cryptinc.com