mail-code

Automates temporary email account creation and verification code retrieval via the mail.tm API.

2|1|Updated Aug 28, 2026
One-click install
npx skills add https://github.com/lycheer1126/xs-bigdan --skill mail-code-lycheer1126
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mail-code
Source: https://github.com/lycheer1126/xs-bigdan/tree/main/knowledge/skills/mail_code
Command: npx skills add https://github.com/lycheer1126/xs-bigdan --skill mail-code-lycheer1126

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? During authorized security testing, a target site often requires email registration but no test account credentials are provided. This Skill creates a temporary mailbox, receives verification codes automatically, and establishes an authenticated session so post-login attack surfaces (IDOR, privilege escalation, business logic flaws) become testable. ## Core Features & Use Cases - Temporary Mailbox Creation: Calls the mail.tm public REST API (no API key required) to create a random-address mailbox and returns address, password, and token as JSON. - Verification Code Polling: Polls the inbox with exponential backoff, extracting 4-8 digit codes from emails, with configurable timeout for delayed delivery. - Credential Persistence: Writes registered account credentials to an evidence file so subsequent testing phases automatically recognize an authenticated state. - Use Case: While testing an authorized target whose JS reveals a register-plus-email-verification flow, create a mailbox, register on the target, poll for the code, complete verification, and then test authenticated endpoints for IDOR and account-takeover flaws such as registration endpoints that ignore password validation. ## Quick Start Ask the agent to use the mail_code tool to create a temporary mailbox, register an account on the target's email signup flow, and poll for the verification code to obtain an authenticated session.

Frequently Asked Questions about mail-code

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I receive email verification codes automatically during penetration testing?

Use the mail.tm public API to create a temporary mailbox, register on the target with that address, then poll the inbox with the mail_code script. It extracts 4-8 digit codes automatically and returns them as JSON, with a default 180-second timeout.

What tool can create temporary email accounts without an API key?

The mail.tm service offers a free public REST API requiring no API key. The mail_code.py script wraps it using only Python standard library, handling domain discovery, random address generation, account creation, and inbox polling.

Does temporary email registration work on all target websites?

No. Many domestic Chinese services (WeChat, Taobao, Douyin) block temporary email domains, and some targets reject them at registration. If the target blocks the domain, switch to unauthenticated attack surfaces instead of retrying.

Why is my verification email not arriving in the temporary inbox?

Delivery delays of 1-3 minutes are common. The poll command uses exponential backoff; increase the timeout with --timeout 300 and rerun. The account is not deleted on timeout, so polling can resume against the same address.

What should I test after registering an account with a temporary email?

First check whether the registration endpoint ignores password validation and issues valid tokens for any input, then retry with another person's email to test account takeover. Afterwards apply IDOR and business-logic testing on the authenticated attack surface.