KeyID Agent Kit

v1.0.0Communicationstable

Provides AI agents with a free, functional email address via the Model Context Protocol without requiring manual registration. It enables comprehensive email capabilities including sending, receiving, and managing messages, contacts, and automated se

agentai-agentclaudeemailkeyid
Share:
704
Stars
0
Downloads
0
Weekly
0/5

What is KeyID Agent Kit?

KeyID Agent Kit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides ai agents with a free, functional email address via the model context protocol without requiring manual registration. it enables comprehensive email capabilities including sending, receiving,...

Provides AI agents with a free, functional email address via the Model Context Protocol without requiring manual registration. It enables comprehensive email capabilities including sending, receiving, and managing messages, contacts, and automated se

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Provides AI agents with a free, functional email address via

Use Cases

Free AI-agent email address
Email, SMS and messaging management
Automated message filtering
KeyID-AI

Maintainer

LicenseMIT License
Languagejavascript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx keyid-agent-kit

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use KeyID Agent Kit

KeyID Agent Kit gives AI agents a fully functional email address without manual registration by provisioning identities through the KeyID.ai platform. It exposes 27 MCP tools covering the complete email lifecycle: sending (with HTML, scheduling, and display names), inbox management, thread organization, drafts, contacts, auto-reply settings, webhooks, and usage analytics. Developers building autonomous agents that need to communicate via email — without relying on personal inboxes or OAuth flows — can drop this server in and have a working email identity in minutes.

Prerequisites

  • Node.js 18 or later installed
  • A KeyID.ai account with an Ed25519 keypair (KEYID_PUBLIC_KEY and KEYID_PRIVATE_KEY)
  • An MCP-compatible client such as Claude Desktop or Cursor
  • npm or npx available on your PATH
1

Install the package

Install the KeyID Agent Kit package globally or run it directly via npx. The package name on npm is @keyid/agent-kit.

npm install -g @keyid/agent-kit
2

Generate an Ed25519 keypair

KeyID uses Ed25519 key pairs for agent identity. Generate a keypair using Node.js crypto or the keyid CLI, then copy the hex-encoded public and private keys.

node -e "const {generateKeyPairSync}=require('crypto');const {publicKey,privateKey}=generateKeyPairSync('ed25519');console.log('public:',publicKey.export({type:'spki',format:'der'}).toString('hex'));console.log('private:',privateKey.export({type:'pkcs8',format:'der'}).toString('hex'));"
3

Configure environment variables

Set the three required environment variables. KEYID_PUBLIC_KEY and KEYID_PRIVATE_KEY are your hex-encoded keypair. KEYID_BASE_URL defaults to https://keyid.ai and only needs to be changed for self-hosted deployments.

export KEYID_PUBLIC_KEY="<your-hex-public-key>"
export KEYID_PRIVATE_KEY="<your-hex-private-key>"
export KEYID_BASE_URL="https://keyid.ai"
4

Add the server to your MCP client config

Add the keyid-agent-kit entry to your claude_desktop_config.json (Claude Desktop) or equivalent MCP client configuration file.

{
  "mcpServers": {
    "keyid-agent-kit": {
      "command": "npx",
      "args": ["@keyid/agent-kit"],
      "env": {
        "KEYID_PUBLIC_KEY": "<your-hex-public-key>",
        "KEYID_PRIVATE_KEY": "<your-hex-private-key>",
        "KEYID_BASE_URL": "https://keyid.ai"
      }
    }
  }
}
5

Restart your MCP client and verify

Restart Claude Desktop (or your MCP client) so it picks up the new server. The agent should now have access to 27 email tools including keyid_send_email, keyid_get_inbox, and keyid_reply.

KeyID Agent Kit Examples

Client configuration

Full claude_desktop_config.json entry for the KeyID Agent Kit MCP server.

{
  "mcpServers": {
    "keyid-agent-kit": {
      "command": "npx",
      "args": ["@keyid/agent-kit"],
      "env": {
        "KEYID_PUBLIC_KEY": "your_hex_encoded_public_key",
        "KEYID_PRIVATE_KEY": "your_hex_encoded_private_key",
        "KEYID_BASE_URL": "https://keyid.ai"
      }
    }
  }
}

Prompts to try

Example prompts that exercise the email tools provided by this server.

- "Check my inbox and summarize any unread messages from the last 24 hours."
- "Send an HTML email to [email protected] with subject 'Hello' and a short greeting."
- "Set up an auto-reply message for when I'm unavailable."
- "Create a contact named Alice Smith with email [email protected]."
- "Forward the latest thread from my inbox to [email protected] with a brief note."

Troubleshooting KeyID Agent Kit

Authentication errors when the server starts

Verify that KEYID_PUBLIC_KEY and KEYID_PRIVATE_KEY are valid hex-encoded Ed25519 keys and that your KeyID.ai account is active. The keys must be in DER-exported hex format, not PEM.

Tools not appearing in the MCP client

Ensure you are running Node.js 18+ and that npx can resolve @keyid/agent-kit. Run 'npx @keyid/agent-kit' directly in a terminal to check for errors before adding it to the config.

Emails not being delivered

Check that your agent's provisioned email address is active by calling the identity provisioning tool first. If KEYID_BASE_URL is set incorrectly, reset it to https://keyid.ai.

Frequently Asked Questions about KeyID Agent Kit

What is KeyID Agent Kit?

KeyID Agent Kit is a Model Context Protocol (MCP) server that provides ai agents with a free, functional email address via the model context protocol without requiring manual registration. it enables comprehensive email capabilities including sending, receiving, and managing messages, contacts, and automated se It connects AI assistants to external tools and data sources through a standardized interface.

How do I install KeyID Agent Kit?

Follow the installation instructions on the KeyID Agent Kit GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with KeyID Agent Kit?

KeyID Agent Kit works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is KeyID Agent Kit free to use?

Yes, KeyID Agent Kit is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "keyid-agent-kit": { "command": "npx", "args": ["-y", "keyid-agent-kit"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use KeyID Agent Kit?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides