KeyID agent-kit

@keyid/agent-kit

An MCP server that gives an agent a real email address: 27 tools for sending, replying, inbox search and contacts

MCP serverOfficial

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • Sends and receives real email on the agent's behalf
  • Can set auto-reply and scheduled delivery through an external service
All reasons and checks

keyid-ai/agent-kit

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/keyid-agent-kit

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Assembled automatically, review before installing.

This entry is high risk, so there is no one-click install. Review the code and add the config by hand.

Run in a terminal

claude mcp add --transport stdio --env 'KEYID_PUBLIC_KEY=<your KEYID_PUBLIC_KEY>' --env 'KEYID_PRIVATE_KEY=<your KEYID_PRIVATE_KEY>' --env KEYID_BASE_URL=https://keyid.ai keyid -- npx @keyid/agent-kit

Or add to the file .mcp.json, in the project

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

If the file already exists, add the server inside the mcpServers key.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.cursor/mcp.json, for all projects

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

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

code --add-mcp '{"name":"keyid","type":"stdio","command":"npx","args":["@keyid/agent-kit"],"env":{"KEYID_PUBLIC_KEY":"<your KEYID_PUBLIC_KEY>","KEYID_PRIVATE_KEY":"<your KEYID_PRIVATE_KEY>","KEYID_BASE_URL":"https://keyid.ai"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "keyid": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@keyid/agent-kit"
      ],
      "env": {
        "KEYID_PUBLIC_KEY": "<your KEYID_PUBLIC_KEY>",
        "KEYID_PRIVATE_KEY": "<your KEYID_PRIVATE_KEY>",
        "KEYID_BASE_URL": "https://keyid.ai"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add keyid --env 'KEYID_PUBLIC_KEY=<your KEYID_PUBLIC_KEY>' --env 'KEYID_PRIVATE_KEY=<your KEYID_PRIVATE_KEY>' --env KEYID_BASE_URL=https://keyid.ai -- npx @keyid/agent-kit

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.keyid]
command = "npx"
args = ["@keyid/agent-kit"]
env = { KEYID_PUBLIC_KEY = "<your KEYID_PUBLIC_KEY>", KEYID_PRIVATE_KEY = "<your KEYID_PRIVATE_KEY>", KEYID_BASE_URL = "https://keyid.ai" }

If the file already exists, append the block to the end.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

gemini mcp add -s user -e 'KEYID_PUBLIC_KEY=<your KEYID_PUBLIC_KEY>' -e 'KEYID_PRIVATE_KEY=<your KEYID_PRIVATE_KEY>' -e KEYID_BASE_URL=https://keyid.ai keyid npx @keyid/agent-kit

Or add to the file ~/.gemini/settings.json, for all projects

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

If the file already exists, add the server inside the mcpServers key.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

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

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

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

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

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

If the file already exists, add the server inside the mcpServers key.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "keyid": {
      "type": "local",
      "command": [
        "npx",
        "@keyid/agent-kit"
      ],
      "environment": {
        "KEYID_PUBLIC_KEY": "<your KEYID_PUBLIC_KEY>",
        "KEYID_PRIVATE_KEY": "<your KEYID_PRIVATE_KEY>",
        "KEYID_BASE_URL": "https://keyid.ai"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "keyid": {
      "command": "npx",
      "args": [
        "@keyid/agent-kit"
      ],
      "env": {
        "KEYID_PUBLIC_KEY": "<your KEYID_PUBLIC_KEY>",
        "KEYID_PRIVATE_KEY": "<your KEYID_PRIVATE_KEY>",
        "KEYID_BASE_URL": "https://keyid.ai"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

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

If the file already exists, add the server inside the mcpServers key.

Keys and settings

KEYID_PUBLIC_KEYsecret, required
Ed25519 public key (hex)
KEYID_PRIVATE_KEYsecret, required
Ed25519 private key (hex)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: Node.js

Checked against the repository on Sep 26, 2026, commit 73b8420.

Text for your agent

Connect the server to your client as MCP: command npx @keyid/agent-kit with KEYID_PUBLIC_KEY and KEYID_PRIVATE_KEY. Keep sending mail behind confirmation.

Other ways from the author
npm install @keyid/agent-kit

Run via npx @keyid/agent-kit with KEYID_PUBLIC_KEY and KEYID_PRIVATE_KEY, then connect as MCP.

This is third-party code. Review the repository files before installing.

What it does

agent-kit is an MCP server that gives an AI agent a real email address and 27 tools for handling mail: send, receive, reply, inbox search, contact management, auto-reply and scheduled delivery. It runs on the KeyID.ai infrastructure, positioned as free email for agents with no human registration and no API keys to manage. The server runs via npx and connects to Claude, Cursor or any MCP client, authenticating with a key pair.

Who it is for. For people building agents that need their own mailbox to send and handle email.

Good fit when

  • The agent needs its own email address to send and receive mail
  • You need inbox search and contact tools
  • You need auto-reply or scheduled delivery from the agent

Not a fit when

  • You need to integrate your own corporate mailbox rather than a KeyID address
  • You cannot let an agent send email without manual confirmation

Example request

Check the inbox, find the message from the contractor and prepare a draft reply

Limitations

Mail runs on the KeyID.ai infrastructure, and the address and message data pass through that service. It needs a KEYID_PUBLIC_KEY and KEYID_PRIVATE_KEY pair. The agent gains the ability to send mail and set auto-reply, so such actions should be kept under control. The repository is small and updated infrequently.

How to disable. Remove the MCP entry from the client config and uninstall the @keyid/agent-kit package; clear the keys from the environment.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
KEYID_PUBLIC_KEY
required
Public key of the agent's KeyID.ai account.
KEYID_PRIVATE_KEY
required, secret
Private key to authenticate the agent with KeyID.ai.

Security check

  • Sends and receives real email on the agent's behalf
  • Can set auto-reply and scheduled delivery through an external service

README in short

The README presents @keyid/agent-kit as a way to give Claude, Cursor or any MCP client a real email address. The server provides 27 MCP tools: send, receive, reply, inbox search, contacts, auto-reply and scheduled delivery. Mail runs on KeyID.ai infrastructure, free and with no human registration or API keys to manage. Install is via npm or running through npx, and the mcpServers config sets the npx @keyid/agent-kit command with the KEYID_PUBLIC_KEY and KEYID_PRIVATE_KEY keys.

FAQ

Is registration or payment needed?

Per the README no: KeyID.ai is positioned as free email for agents with no human registration, only a key pair.

Can the agent send mail itself?

Yes, the 27 tools include send, reply, auto-reply and scheduled delivery, so such actions should be controlled.

Editors’ pick

An MCP server with n8n node and template knowledge: the agent picks nodes, validates configs and, with API access, creates workflows in your n8n

MCP serverHigh riskNo VPN needed23KRepository stars
Official

Zapier's official MCP plugin: the agent gets actions across thousands of apps through your Zapier account

PluginHigh risk421Repository stars

A curated list of Claude skills and plugins, plus Composio's own automation skills for 78 SaaS apps

SkillHigh risk75.8KRepository stars

A plugin and CLI catalog for agents: generates command-line interfaces for GUI apps like GIMP and Blender and installs ready ones via CLI-Hub

PluginHigh riskNo VPN needed50.9KRepository stars
Foxx AIKeyID agent-kit

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.