How do I use KeyID Agent Kit?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@KeyID Agent Kit Check my inbox and summarize the latest message from Alice" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@keyid/agent-kit

Give Claude, Cursor, or any MCP client a real email address. Free. No signup.

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.

Powered by KeyID.ai — free email infrastructure for AI agents. No human registration, no API keys to manage, no cost.

Install

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

Usage

With Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "keyid": {
      "command": "npx",
      "args": ["@keyid/agent-kit"],
      "env": {
        "KEYID_PUBLIC_KEY": "...hex...",
        "KEYID_PRIVATE_KEY": "...hex..."
      }
    }
  }
}

With any MCP client

# Run directly
npx @keyid/agent-kit

# Or with existing keypair
KEYID_PUBLIC_KEY=abc123 KEYID_PRIVATE_KEY=def456 npx @keyid/agent-kit

Environment Variables

Variable	Description	Default
`KEYID_BASE_URL`	API base URL	`https://keyid.ai`
`KEYID_PUBLIC_KEY`	Ed25519 public key (hex)	Auto-generated
`KEYID_PRIVATE_KEY`	Ed25519 private key (hex)	Auto-generated

Tools (27)

Identity & Auth

Tool	Description
`keyid_provision`	Register agent, get email address
`keyid_get_email`	Get current active email

Messages

Tool	Description
`keyid_get_inbox`	Fetch inbox (with search, filtering)
`keyid_send`	Send email (scheduled, display name, HTML)
`keyid_reply`	Reply to a message
`keyid_forward`	Forward a message
`keyid_update_message`	Update read/starred status
`keyid_get_unread_count`	Count unread messages

Threads & Drafts

Tool	Description
`keyid_list_threads`	List conversation threads
`keyid_get_thread`	Get thread with messages
`keyid_create_draft`	Create a draft
`keyid_send_draft`	Send a draft

Settings

Tool	Description
`keyid_get_auto_reply`	Get auto-reply settings
`keyid_set_auto_reply`	Configure vacation responder
`keyid_get_signature`	Get email signature
`keyid_set_signature`	Set email signature
`keyid_get_forwarding`	Get forwarding settings
`keyid_set_forwarding`	Configure forwarding

Contacts

Tool	Description
`keyid_list_contacts`	List saved contacts
`keyid_create_contact`	Create a contact
`keyid_delete_contact`	Delete a contact

Webhooks

Tool	Description
`keyid_list_webhooks`	List webhooks
`keyid_create_webhook`	Create webhook
`keyid_get_webhook_deliveries`	Delivery history

Lists & Metrics

Tool	Description
`keyid_manage_list`	Add/remove from allow/blocklist
`keyid_get_metrics`	Query usage metrics

Example Conversation

User: Check my email

Agent: [calls keyid_get_inbox]
You have 3 new messages:
1. alice@company.com — "Q1 Report" (2 hours ago)
2. bob@partner.org — "Meeting tomorrow" (5 hours ago)
3. noreply@service.com — "Password reset" (1 day ago)

User: Reply to Alice saying I'll review it today

Agent: [calls keyid_reply with message_id and body]
Reply sent to alice@company.com.

Protocol

Uses MCP JSON-RPC over stdio (protocol version 2024-11-05). Compatible with Claude Desktop, Cursor, and any MCP client.

License

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

KeyID Agent Kit