otpkit
MCP server for temporary email & SMS — receive OTPs, verification links, and confirmation codes. Zero API keys required.
Install / Use
claude mcp add SecFathy -- npx -y github:SecFathy/otpkitIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
CommunicationSupported Platforms
Our assessment of otpkit
otpkit scores 79/100 on our quality scale, 367th of 393 Communication skills we index.
Its MCP Server is 16 KB long, well organised into 60 sections with 37 code examples: a thorough specification that gives an agent plenty to work with.
It has 47 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so otpkit is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
otpkit compared with similar skills
All 4 of these similar skills score higher than otpkit; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| otpkit (this skill)by SecFathy | 79 | 47 | today | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.8k | 10d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install otpkit?
- Run
claude mcp add SecFathy -- npx -y github:SecFathy/otpkit. The install tabs above show the steps for each supported agent. - Which AI agents does otpkit work with?
- It is written for Claude Code, Claude Desktop and Cursor, as a MCP Server file. Other agents that read the same format can often use it too.
- Is otpkit safe to use?
- It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is otpkit still maintained?
- The repository was last updated today, so otpkit is actively maintained.
Skill content
View source on GitHubZero API keys required — every email provider and the free SMS source work without authentication.
Table of Contents
- How It Works
- Providers
- Installation
- Setup
- Tools Reference
- Usage Examples
- Architecture
- Troubleshooting
- License
How It Works
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:
- Create a temporary email address or get a free public phone number
- Wait for an incoming message (email or SMS)
- Receive the message with OTP codes and verification links already extracted
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:
- OTP codes: 4–8 digit numbers (e.g.
847291,1234,98765432) - Verification links: URLs containing keywords like
verify,confirm,activate,token,reset,login— ranked first in results
Providers
Email (all free, no API key)
| 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:
- grabmail (default) — best all-round choice. Three domains, no expiry, clean REST API, works worldwide.
- catchmail — same quality as grabmail, different domain. Good as a backup.
- guerrillamail — private with session-based auth. Addresses expire after ~1 hour.
- maildrop — anyone can read any inbox. Use only for non-sensitive tests.
SMS — Free (no auth)
| 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.
SMS — Paid (optional, private numbers)
| 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.
Installation
No install needed (recommended)
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
From GitHub
pip install git+https://github.com/secfathy/otpkit.git
From source
git clone https://github.com/secfathy/otpkit.git
cd otpkit
pip install -e .
Verify installation
otpkit
# Server starts on stdio — press Ctrl+C to stop
Setup
Claude Code (CLI)
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 (macOS / Windows)
- Open Claude Desktop settings
- Go to Developer → Edit Config
- Add otpkit to
claude_desktop_config.json:
{
"mcpServers": {
"otpkit": {
"command": "uvx",
"args": ["otpkit"]
}
}
}
- Restart Claude Desktop
The otpkit tools now appear in Claude's tool list (hammer icon).
Claude Desktop with paid SMS
{
"mcpServers": {
"otpkit": {
"command": "uvx",
"args": ["otpkit"],
"env": {
"FIVESIM_API_KEY": "your-key-here",
"SMSPOOL_API_KEY": "your-key-here"
}
}
}
}
Cursor
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.
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"otpkit": {
"command": "uvx",
"args": ["otpkit"]
}
}
}
Cline (VS Code)
- Open VS Code → Cline sidebar → MCP Servers
- Click Edit MCP Settings
- Add:
{
"mcpServers": {
"otpkit": {
"command": "uvx",
"args": ["otpkit"]
}
}
}
Continue (VS Code / JetBrains)
Add to ~/.continue/config.yaml:
mcpServers:
- name: otpkit
command: otpkit
Zed
Add to Zed settings (settings.json):
{
"context_servers": {
"otpkit": {
"command": {
"path": "otpkit"
}
}
}
}
OpenAI Agents SDK
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],
)
Claude API (Anthropic SDK) with MCP
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
Any MCP Client (Generic)
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.
Smithery Registry
If you use the Smithery MCP registry:
npx @smithery/cli install otpkit --client claude
Tools Reference
Email Tools
create_temp_email
Create 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_email
Check 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_email
Block 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_emails
List all email addresses created in this session.
Returns:
[
{
"address": "tmp1234567@grabmail.io",
"provider": "grabmail",
"age_seconds": 45
}
]
SMS Tools — Free
list_free_sms_numbers
List 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"}
],
"warning": "Public shared numbers — anyone can read messages"
}
read_free_sms
Read recent SMS messages on a public number. Each message is scanned for OTP codes.
| Parameter | Type | Description |
|---|---|---|
| phone | string | Phone number from list_free_sms_numbers |
Returns:
{
"phone": "12543207594",
"source": "receive-sms-free.cc",
"count": 20,
"messages": [
{
"from": "19543583114",
"text": "Your Uber code is 4829",
"date": "2 min ago",
"otps": ["4829"]
}
]
}
wait_for_sms
Poll until a new SMS arrives on a free public number or timeout.
| Parameter | Type | Default | Description |
|---|---|---|---|
| phone | string | — | Phone number to watch |
| timeout | int | 120 | Max seconds to wait (max 300) |
| poll_interval | int | 10 | Seconds between polls (min 5) |
SMS Tools — Paid
get_sms_providers
List all SMS providers and whether they are configured.
Returns:
[
{"name": "receive-sms-free", "type": "free", "auth": "none", "ready": true},
{"name": "5sim", "type": "paid", "env_var": "FIVESIM_API_KEY", "ready": false},
{"name": "smspool", "type": "paid", "env_var": "SMSPOOL_API_KEY", "ready": false}
]
buy_temp_number
Buy a private temporary phone number.
| Parameter | Type | Default | Description |
|---|---|---|---|
| country | string | — | Country code: "russia", "usa", "india", etc. |
| service | string | — | Target service: "telegram", "whatsapp", "google", "any" |
| provider | string | "5sim" | 5sim | smspool |
check_paid_sms
Check if an SMS arrived on a paid number.
| Parameter | Type | Description |
|---|---|---|
| order_id | string | Order ID from buy_temp_number |
Utility
extract_otp_from_text
Extract OTP codes and verification links from any text. Useful for processing messages from other sources.
| Parameter | Type | Description |
|---|---|---|
| text |
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.8kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
