Skip to content
Back to search

agent-kit

Give Claude/Cursor email powers. 27 MCP tools — inbox, send, reply, contacts, search. Free, no signup.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/keyid-ai--agent-kit/badge.svg)](/listings/keyid-ai--agent-kit)

HTML

<a href="/listings/keyid-ai--agent-kit"><img src="/api/listings/keyid-ai--agent-kit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install @keyid/agent-kit
# or
yarn add @keyid/agent-kit

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 135 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # @keyid/agent-kit
  2. **Give Claude, Cursor, or any MCP client a real email address. Free. No signup.**
  3. 27 email tools via Model Context Protocol (MCP): send, receive, reply, search inbox, manage contacts, set auto-reply, schedule delivery — everything an AI agent needs to handle email autonomously.
  4. Powered by [KeyID.ai](https://keyid.ai) — free email infrastructure for AI agents. No human registration, no API keys to manage, no cost.
  5. ## Install
  6. ```bash
  7. npm install @keyid/agent-kit
  8. # or
  9. yarn add @keyid/agent-kit
  10. ```
  11. ## Usage
  12. ### With Claude Desktop
  13. Add to `claude_desktop_config.json`:
  14. ```json
  15. {
  16. "mcpServers": {
  17. "keyid": {
  18. "command": "npx",
  19. "args": ["@keyid/agent-kit"],
  20. "env": {
  21. "KEYID_PUBLIC_KEY": "...hex...",
  22. "KEYID_PRIVATE_KEY": "...hex..."
  23. }
  24. }
  25. }
  26. }
  27. ```
  28. ### With any MCP client
  29. ```bash
  30. # Run directly
  31. npx @keyid/agent-kit
  32. # Or with existing keypair
  33. KEYID_PUBLIC_KEY=abc123 KEYID_PRIVATE_KEY=def456 npx @keyid/agent-kit
  34. ```
  35. ### Environment Variables
  36. | Variable | Description | Default |
  37. |----------|-------------|---------|
  38. | `KEYID_BASE_URL` | API base URL | `https://keyid.ai` |
  39. | `KEYID_PUBLIC_KEY` | Ed25519 public key (hex) | Auto-generated |
  40. | `KEYID_PRIVATE_KEY` | Ed25519 private key (hex) | Auto-generated |
  41. ## Tools (27)
  42. ### Identity & Auth
  43. | Tool | Description |
  44. |------|-------------|
  45. | `keyid_provision` | Register agent, get email address |
  46. | `keyid_get_email` | Get current active email |
  47. ### Messages
  48. | Tool | Description |
  49. |------|-------------|
  50. | `keyid_get_inbox` | Fetch inbox (with search, filtering) |
  51. | `keyid_send` | Send email (scheduled, display name, HTML) |
  52. | `keyid_reply` | Reply to a message |
  53. | `keyid_forward` | Forward a message |
  54. | `keyid_update_message` | Update read/starred status |
  55. | `keyid_get_unread_count` | Count unread messages |
  56. ### Threads & Drafts
  57. | Tool | Description |
  58. |------|-------------|
  59. | `keyid_list_threads` | List conversation threads |
  60. | `keyid_get_thread` | Get thread with messages |
  61. | `keyid_create_draft` | Create a draft |
  62. | `keyid_send_draft` | Send a draft |
  63. ### Settings
  64. | Tool | Description |
  65. |------|-------------|
  66. | `keyid_get_auto_reply` | Get auto-reply settings |
  67. | `keyid_set_auto_reply` | Configure vacation responder |
  68. | `keyid_get_signature` | Get email signature |
  69. | `keyid_set_signature` | Set email signature |
  70. | `keyid_get_forwarding` | Get forwarding settings |
  71. | `keyid_set_forwarding` | Configure forwarding |
  72. ### Contacts
  73. | Tool | Description |
  74. |------|-------------|
  75. | `keyid_list_contacts` | List saved contacts |
  76. | `keyid_create_contact` | Create a contact |
  77. | `keyid_delete_contact` | Delete a contact |
  78. ### Webhooks
  79. | Tool | Description |
  80. |------|-------------|
  81. | `keyid_list_webhooks` | List webhooks |
  82. | `keyid_create_webhook` | Create webhook |
  83. | `keyid_get_webhook_deliveries` | Delivery history |
  84. ### Lists & Metrics
  85. | Tool | Description |
  86. |------|-------------|
  87. | `keyid_manage_list` | Add/remove from allow/blocklist |
  88. | `keyid_get_metrics` | Query usage metrics |
  89. ## Example Conversation
  90. ```
  91. User: Check my email
  92. Agent: [calls keyid_get_inbox]
  93. You have 3 new messages:
  94. 1. alice@company.com — "Q1 Report" (2 hours ago)
  95. 2. bob@partner.org — "Meeting tomorrow" (5 hours ago)
  96. 3. noreply@service.com — "Password reset" (1 day ago)
  97. User: Reply to Alice saying I'll review it today
  98. Agent: [calls keyid_reply with message_id and body]
  99. Reply sent to alice@company.com.
  100. ```
  101. ## Protocol
  102. Uses MCP JSON-RPC over stdio (protocol version 2024-11-05). Compatible with Claude Desktop, Cursor, and any MCP client.
  103. ## License
  104. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.