# keyid-agent-kit-mcp

Provides AI agents with a working email address and 27 MCP tools for sending messages, searching the inbox, and managing contacts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/keyid-agent-kit-mcp/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/keyid-agent-kit-mcp

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/keyid-agent-kit-mcp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/keyid-agent-kit-mcp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/keyid-agent-kit-mcp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/keyid-agent-kit-mcp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills keyid-agent-kit-mcp
```

2. **Manually: put the files in place**
- File: `.github/skills/keyid-agent-kit-mcp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/keyid-agent-kit-mcp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/keyid-agent-kit-mcp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill keyid-agent-kit-mcp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/keyid-agent-kit-mcp/SKILL.md

## When to use it
- 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
- 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

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 139 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md