SkillAgentSearch skills...

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/otpkit

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

79/100

Supported Platforms

Claude Code
Claude Desktop
Cursor

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.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
7/20
Freshness
15/15

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.

SkillScoreStarsUpdatedFormat
otpkit (this skill)by SecFathy7947todayMCP Server
Agent-Reachby Panniantong100112.8k10d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.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.
<p align="center"> <img src="banner.png" alt="otpKit — MCP server for temporary email and SMS" width="100%"> </p> <h1 align="center">otpkit</h1> <p align="center"> An MCP server that creates disposable email addresses and phone numbers, checks their inboxes, and automatically extracts OTP codes and verification links from incoming messages. </p>

Zero API keys required — every email provider and the free SMS source work without authentication.


Table of Contents


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:

  1. Create a temporary email address or get a free public phone number
  2. Wait for an incoming message (email or SMS)
  3. 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

uvx fetches and runs the package in an isolated environment. If you don't have uv, 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)

  1. Open Claude Desktop settings
  2. Go to Developer → Edit Config
  3. Add otpkit to claude_desktop_config.json:
{
  "mcpServers": {
    "otpkit": {
      "command": "uvx",
      "args": ["otpkit"]
    }
  }
}
  1. 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)

  1. Open VS Code → Cline sidebar → MCP Servers
  2. Click Edit MCP Settings
  3. 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

View on GitHub
GitHub Stars47
CategoryCommunication
Updated14h ago
Forks1

Languages

Python

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info