ClaudeMap

otpkit

An MCP server that mints disposable email addresses and phone numbers, watches the inboxes, and returns verification codes and links already extracted — zero API keys for every email provider and the free SMS source

MCP Serversmcp servertestingemailsmsotppythonpip

otpkit gives MCP-compatible clients — Claude Code, Claude Desktop, Cursor or your own agents — a sign-up-testing toolkit: create_temp_email mints an address (grabmail by default, plus catchmail, guerrillamail and maildrop; list_temp_emails tracks what you created), wait_for_email and check_email poll the inbox and scan every message for OTP codes (4-8 digits) and verification links so the agent can paste them straight into the form; extract_otp_from_text digs codes out of arbitrary text. SMS comes in two tiers: a free source of public shared numbers (list_free_sms_numbers, read_free_sms, wait_for_sms with a timeout) and optional paid private numbers from 5sim or smspool (get_sms_providers, buy_temp_number, check_paid_sms, enabled with the FIVESIM_API_KEY / SMSPOOL_API_KEY env vars). Every email provider and the free SMS source work without authentication; the whole server is a pip package you install from this repo with one pip command (pip install git+https://github.com/secfathy/otpkit.git — it is not on PyPI yet) and register in Claude Code with one command. Eleven tools in total; the README includes an architecture diagram, usage examples and a troubleshooting section (free numbers are scraped from a public site, so an empty result may just mean no recent messages).

What it does

  • 11 tools across email and SMS: create_temp_email, check_email, wait_for_email, list_temp_emails, list_free_sms_numbers, read_free_sms, wait_for_sms, get_sms_providers, buy_temp_number, check_paid_sms, extract_otp_from_text
  • OTPs and verification links extracted automatically from every incoming message (4-8 digit codes), so the agent can complete a sign-up end to end
  • Four no-key email providers: grabmail (default, three domains), catchmail, guerrillamail (~1 hour expiry), maildrop
  • Two SMS tiers: free public shared numbers, or private numbers via 5sim / smspool with API keys
  • Install from the repo with one pip command (pip install git+https://github.com/secfathy/otpkit.git — not on PyPI yet); Claude Code registration is one command; complete claude_desktop_config.json / .cursor/mcp.json blocks documented

When to use it

Use when your agent needs to test a sign-up, verification or notification flow end to end — staging a new account creation in an E2E test, checking that your OTP email renders and its codes parse, or wiring a QA agent that registers demo accounts on your own service. For real personal accounts, skip the free SMS tier entirely.

Getting started

Install from this repo (needs Python 3.10+; otpkit is not on PyPI yet):

pip install git+https://github.com/secfathy/otpkit.git

Claude Code, one command:

claude mcp add otpkit -- otpkit

Claude Desktop — Developer → Edit Config, add to claude_desktop_config.json:

{
  "mcpServers": {
    "otpkit": {
      "command": "otpkit"
    }
  }
}

For paid private SMS numbers, add the provider keys to that object's env ("FIVESIM_API_KEY", "SMSPOOL_API_KEY"). Same JSON shape for Cursor in .cursor/mcp.json. Verify with claude mcp list; run otpkit to check the install — the server starts on stdio (Ctrl+C to stop).

Things to know

Privacy tiers matter here and the README is explicit: maildrop inboxes are public — anyone can read any inbox; the free SMS source is publicly shared numbers — the README warns to never use them for real accounts or sensitive services; grabmail, catchmail and guerrillamail are private. Free numbers are scraped from a public site, so an empty wait_for_sms result may just mean no recent messages on that number (try another from list_free_sms_numbers). guerrillamail addresses expire after about an hour. Paid SMS needs its own 5sim/smspool account and key. OTP automation is a tool that cuts both ways: the project frames it for testing, and the same boundary applies when you use it — keep it on your own services and throwaway flows. One install-channel note verified on 2026-11-18: the project's pyproject.toml declares otpkit 1.0.0, but the package has not been published to PyPI, so uvx otpkit does not resolve — install from this repo with pip and register the otpkit command. MIT. 42 stars as of writing (2026-11-18).

Repository

SecFathy/otpkit

Charted

Related on the map

  • Blitz Strike

    MCP Server

    A penetration-testing methodology delivered as one MCP server: BLITZ maps the attack surface, EAGLE-EYE traces source-to-sink, STRIKE live-verifies every finding before it is reported.

    • mcp-server
    • security
    • pentest
    • methodology
  • Ripwire

    MCP Server

    Red Hat's "ripgrep for AI context" — a C++23 zero-dependency CLI that also speaks MCP.

    • mcp
    • code-context
    • cli
    • red-hat
  • Deja Vu

    MCP Server

    One shared session memory for 25+ coding agents — Claude Code, Codex, and Cursor finally remember the same project.

    • mcp
    • memory
    • cross-agent
    • context