by SecFathy
MCP server for temporary email & SMS — receive OTPs, verification links, and confirmation codes. Zero API keys required.
# Add to your Claude Code skills
git clone https://github.com/SecFathy/otpkitGuides for using mcp servers skills like otpkit.
See how otpkit compares with popular alternatives.
otpkit is an open-source mcp servers skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by SecFathy. MCP server for temporary email & SMS — receive OTPs, verification links, and confirmation codes. Zero API keys required. It has 59 GitHub stars.
otpkit's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/SecFathy/otpkit" and add it to your Claude Code skills directory (see the Installation section above).
otpkit is primarily written in Python. It is open-source under SecFathy on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other MCP Servers skills you can browse and compare side by side. Open the MCP Servers category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh otpkit against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
Zero API keys required — every email provider and the free SMS source work without authentication.
otpkit runs as an MCP (Model Context Protocol) server. Any MCP-compatible client — Claude Code, Claude Desktop, Cursor, or your own agent — can call its tools to:
Agent otpkit Provider
│ │ │
├─ create_temp_email() ───────►│ │
│◄─ {"address": "x@grab..."}──┤ │
│ │ │
│ [uses address to sign up on a website] │
│ │ │
├─ wait_for_email() ──────────►│──── poll every 5s ──────────►│
│ │◄─── new message ─────────────┤
│ │ │
│ │ extract OTPs + links │
│ │ │
│◄─ {"otps": ["847291"]} ─────┤ │
│ │ │
│ [enters OTP on the website] │
All extraction happens automatically — every message is scanned for:
847291, 1234, 98765432)verify, confirm, activate, token, reset, login — ranked first in results| Provider | Domain(s) | Privacy | Expiry | Method |
|---|---|---|---|---|
grabmail |
grabmail.io, mixozia.com, linqmail.com | Private | None | REST |
catchmail |
catchmail.io | Private | None | REST |
guerrillamail |
guerrillamailblock.com + others | Private | ~1 hour | REST |
maildrop |
maildrop.cc | Public | None | GraphQL |
Choosing a provider:
| Source | Site | Type |
|---|---|---|
| receive-sms-free.cc | receive-sms-free.cc | Public shared numbers |
Warning: Free SMS numbers are publicly shared — anyone can see the messages. Never use them for real accounts or sensitive services.
| Provider | Env Variable | Site |
|---|---|---|
5sim |
FIVESIM_API_KEY |
5sim.net |
smspool |
SMSPOOL_API_KEY |
smspool.net |
Paid providers give you a private temporary number that only you can read. Set the API key as an environment variable to enable them.
Use uvx to run directly from the repo — nothing to install:
uvx otpkit
uvxfetches and runs the package in an isolated environment. If you don't haveuv, install it:pip install uv
pip install git+https://github.com/secfathy/otpkit.git
git clone https://github.com/secfathy/otpkit.git
cd otpkit
pip install -e .
otpkit
# Server starts on stdio — press Ctrl+C to stop
Quickest — install and register in one command (no clone needed):
claude mcp add otpkit -- uvx otpkit
Or if you installed via pip:
claude mcp add otpkit -- otpkit
Or using the Python module directly:
claude mcp add otpkit -- python -m src.server
To verify it's registered:
claude mcp list
Now in any Claude Code session you can say:
"Create a temp email and wait for the verification code"
Claude will call create_temp_email, wait_for_email, and return the OTP automatically.
claude_desktop_config.json:{
"mcpServers": {
"otpkit": {
"command": "uvx",
"args": ["otpkit"]
}
}
}
The otpkit tools now appear in Claude's tool list (hammer icon).
{
"mcpServers": {
"otpkit": {
"command": "uvx",
"args": ["otpkit"],
"env": {
"FIVESIM_API_KEY": "your-key-here",
"SMSPOOL_API_KEY": "your-key-here"
}
}
}
}
Add to .cursor/mcp.json in your project root (or global ~/.cursor/mcp.json):
{
"mcpServers": {
"otpkit": {
"command": "uvx",
"args": ["otpkit"]
}
}
}
Restart Cursor. The tools appear in Cursor's MCP panel.
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"otpkit": {
"command": "uvx",
"args": ["otpkit"]
}
}
}
{
"mcpServers": {
"otpkit": {
"command": "uvx",
"args": ["otpkit"]
}
}
}
Add to ~/.continue/config.yaml:
mcpServers:
- name: otpkit
command: otpkit
Add to Zed settings (settings.json):
{
"context_servers": {
"otpkit": {
"command": {
"path": "otpkit"
}
}
}
}
from openai_agents import Agent, MCPServerStdio
otpkit = MCPServerStdio(command="otpkit")
agent = Agent(
name="signup-agent",
instructions="Use otpkit to create temp emails and extract OTPs.",
mcp_servers=[otpkit],
)
import anthropic
from anthropic.types import MCPServerStdio
client = anthropic.Anthropic()
server = MCPServerStdio(command="otpkit")
# Use with tool_use in Messages API
# The server exposes 11 tools that Claude can call
otpkit uses stdio transport — it reads JSON-RPC from stdin and writes to stdout. Any MCP-compatible client can use it:
# Command to run:
otpkit
# Or with Python directly:
python -m src.server
The server exposes 11 tools. Use your client's MCP configuration to point at the otpkit command.
If you use the Smithery MCP registry:
npx @smithery/cli install otpkit --client claude
create_temp_emailCreate a disposable email address.
| Parameter | Type | Default | Description |
|---|---|---|---|
provider |
string | "grabmail" |
grabmail | catchmail | guerrillamail | maildrop |
username |
string | random | Custom username prefix (e.g. "john" → john@grabmail.io) |
Returns:
{
"address": "tmp1234567@grabmail.io",
"provider": "grabmail",
"domains": ["grabmail.io", "mixozia.com", "linqmail.com"]
}
check_emailCheck inbox for new messages. Every message is automatically enriched with extracted OTPs and links.
| Parameter | Type | Description |
|---|---|---|
address |
string | Email address created with create_temp_email |
Returns:
{
"address": "tmp1234567@grabmail.io",
"provider": "grabmail",
"count": 1,
"messages": [
{
"id": "abc123",
"from": "noreply@example.com",
"subject": "Verify your email",
"body": "Your verification code is 847291",
"otps": ["847291"],
"links": ["https://example.com/verify?token=xyz"]
}
]
}
wait_for_emailBlock until a new email arrives or timeout. Polls automatically.
| Parameter | Type | Default | Description |
|---|---|---|---|
address |
string | — | Email address to watch |
timeout |
int | 60 |
Max seconds to wait (max 120) |
poll_interval |
int | 5 |
Seconds between polls (min 3) |
Returns (on success):
{
"status": "received",
"waited_seconds": 12,
"from": "noreply@example.com",
"subject": "Verify your email",
"body": "Your code is 847291",
"otps": ["847291"],
"links": ["https://example.com/verify?token=xyz"]
}
Returns (on timeout):
{
"status": "timeout",
"waited_seconds": 60
}
list_temp_emailsList all email addresses created in this session.
Returns:
[
{
"address": "tmp1234567@grabmail.io",
"provider": "grabmail",
"age_seconds": 45
}
]
list_free_sms_numbersList available public phone numbers for receiving SMS. No parameters needed.
Returns:
{
"source": "receive-sms-free.cc",
"count": 24,
"numbers": [
{"phone": "12543207594", "country": "USA"},
{"phone": "447700900000", "country": "UK"}