# dsh-kankan-mail

[DSH](https://github.com/deepseek-ai/deepseek-harness) plugin exposing [kankan.email](https://kankan.email) (AI Agent mailboxes) as MCP tools. Zero dependencies — a single `mcp-server.js` Node script speaking NDJSON JSON-RPC over stdio.

## Tools

| Tool | Description |
| --- | --- |
| `create_mailbox(name_hint?)` | Create a mailbox; returns the address + `mail_key` (save the key!) |
| `list_messages(address?, key?, after_id?)` | List received messages (incremental via `after_id`) |
| `send_mail(to, subject, body, address?, key?)` | Send an email from the mailbox |
| `renew_mailbox(address?, key?)` | Renew the mailbox |
| `pay_order(order_no, method)` | Pay an order |
| `order_status(order_no)` | Query order status |

## Install

```bash
npx @deepseek-ai/dsh plugin --profile web add github:zhulianxing/dsh-kankan-mail
```

## Configuration

Set environment variables before launching DSH (they are forwarded to the MCP server):

- `KANKAN_ADDRESS` — default mailbox address (optional; can be passed per tool call)
- `KANKAN_MAIL_KEY` — default `mail_key` (optional; can be passed per tool call)

Note: outbound send uses the `X-Mail-Key` header carrying your `mail_key`. If kankan.email changes its auth header name, adjust `mailHeaders()` in `mcp-server.js`.

## License

MIT