keyid-agent-kit-mcp — Claude Code skill: what it does, how to install
Provides AI agents with a working email address and 27 MCP tools for sending messages, searching the inbox, and managing contacts.
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a claude-codeWhat keyid-agent-kit-mcp does
This skill hooks your agent into KeyID.ai through the @keyid/agent-kit stdio MCP server. The agent gets an address immediately. It exposes 27 distinct tools handling message filtering, replies, thread lookups, drafts, auto-responders, and signature templates.
Cryptographic identity relies on Ed25519 keypairs. The process creates a pair on initial startup and logs both values to stderr. Unless you export those keys as KEYID_PUBLIC_KEY and KEYID_PRIVATE_KEY in your environment, the server spins up a fresh keypair on the next launch and assigns a different address. No account registration or manual tokens are needed.
The server also includes tools for contact storage, address allowlists, delivery metric queries, and inbound webhook endpoints. Network requests route to https://keyid.ai.
What it helps with
- Assign an active email inbox to an AI agent
- Search and read incoming email threads directly through MCP
- Set up automatic replies and forwarding rules
- Manage contact lists and monitor delivery metrics
Example prompts for the agent
- Check the inbox for unread messages sent by team members
- Draft a project update email and send it to the contact list
- Query KeyID metrics to verify delivery numbers and bounce rates
How to install keyid-agent-kit-mcp
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a claude-code2Manually: put the files in place
~/.claude/skills/keyid-agent-kit-mcp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/keyid-agent-kit-mcp/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a codex2Manually: put the files in place
.agents/skills/keyid-agent-kit-mcp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a cursor2Manually: put the files in place
.cursor/skills/keyid-agent-kit-mcp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills keyid-agent-kit-mcp2Manually: put the files in place
.github/skills/keyid-agent-kit-mcp/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/keyid-agent-kit-mcpManually: put the files in place
.devin/skills/keyid-agent-kit-mcp/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about keyid-agent-kit-mcp
How do I install keyid-agent-kit-mcp in Claude Code?
Run npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a claude-code in your terminal.
What does keyid-agent-kit-mcp do?
It provides an MCP server configuration that links the agent to KeyID.ai, giving it 27 email management tools without requiring account sign-up.
How do I keep the same email address across restarts?
Capture the generated Ed25519 keys printed to stderr during the first run, then set them as KEYID_PUBLIC_KEY and KEYID_PRIVATE_KEY in your environment.