Your Shield Against Spam & For Your Online Privacy
Programmatically generate temporary emails, check inboxes, and read messages. Integrate via REST API or MCP Server.
Get up and running in under a minute. Register for an API key, then start making requests.
Sign in via the web interface and generate your API key:
curl -X GET https://www.1tempmail.com/api/v1/key \
-H "Authorization: Bearer YOUR_API_KEY"curl -X POST https://www.1tempmail.com/api/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY"All API requests require a Bearer token in the Authorization header. Register an account and retrieve your API key using the endpoints above.
Include your API key in every request:
Authorization: Bearer your_api_key_hereNever expose your API key in client-side code or public repositories. Store it in environment variables or a secrets manager.
The 1TempMail MCP Server exposes three tools that AI assistants can call directly. Connect via the MCP endpoint at https://www.1tempmail.com/mcp.
Generate a new temporary email address. The email remains active for 60 minutes and can receive messages during that time.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain |
string | optional | Preferred domain for the email address. If omitted, a random domain is assigned. |
{
"email": "abc123@1tempmail.com",
"token": "sid_a8f3c2d1e4b56790",
"expires_at": "2026-07-07T12:00:00Z"
}Retrieve all messages currently in the inbox for a given temporary email address.
| Parameter | Type | Required | Description |
|---|---|---|---|
token |
string | required | The session token returned by generate_email. |
{
"email": "abc123@1tempmail.com",
"messages": [
{
"id": "msg_01HZ3QK7M8NP",
"from": "noreply@example.com",
"subject": "Verify your email address",
"date": "2026-07-07T10:30:00Z",
"preview": "Your verification code is 482917..."
}
],
"count": 1
}Retrieve the full content of a specific message, including the HTML body and attachments metadata.
| Parameter | Type | Required | Description |
|---|---|---|---|
token |
string | required | The session token returned by generate_email. |
message_id |
string | required | The message ID from check_inbox. |
{
"id": "msg_01HZ3QK7M8NP",
"from": "noreply@example.com",
"to": "abc123@1tempmail.com",
"subject": "Verify your email address",
"date": "2026-07-07T10:30:00Z",
"body_html": "<div>Your verification code is <b>482917</b>...</div>",
"body_text": "Your verification code is 482917...",
"attachments": []
}Add the 1TempMail MCP Server to your AI tool by adding the configuration below to your settings file.
Add to ~/.claude/settings.json or your project's .claude/settings.json:
{
"mcpServers": {
"1tempmail": {
"command": "npx",
"args": ["-y", "@1tempmail/mcp-server"],
"env": {
"1TEMPMAIL_API_KEY": "your_api_key_here"
}
}
}
}Add to ~/.cursor/mcp.json or your project's .cursor/mcp.json:
{
"mcpServers": {
"1tempmail": {
"command": "npx",
"args": ["-y", "@1tempmail/mcp-server"],
"env": {
"1TEMPMAIL_API_KEY": "your_api_key_here"
}
}
}
}For Windsurf, Cline, or any MCP-compatible tool, add the same server config to your tool's MCP settings file:
{
"mcpServers": {
"1tempmail": {
"command": "npx",
"args": ["-y", "@1tempmail/mcp-server"],
"env": {
"1TEMPMAIL_API_KEY": "your_api_key_here"
}
}
}
}If your tool supports remote MCP servers via SSE, you can also connect directly:
https://www.1tempmail.com/mcpBase URL: https://www.1tempmail.com/api/v1
Retrieve your API key information. Requires Bearer auth with your API key.
curl -X GET https://www.1tempmail.com/api/v1/key \
-H "Authorization: Bearer YOUR_API_KEY"
# Response
{
"api_key": "tmp_live_k8x...qz2",
"plan": "free",
"created_at": "2026-07-07T10:00:00Z"
}Check your current billing period usage and rate limit details.
curl -X GET https://www.1tempmail.com/api/v1/usage \
-H "Authorization: Bearer YOUR_API_KEY"
# Response
{
"plan": "free",
"requests_used": 42,
"requests_limit": 100,
"period_end": "2026-08-01T00:00:00Z"
}List all available pricing plans with their features and limits.
curl -X GET https://www.1tempmail.com/api/v1/plans
# Response
{
"plans": [
{ "id": "free", "name": "Free", "price": 0, "requests_per_month": 100 },
{ "id": "pro", "name": "Pro", "price": 9, "requests_per_month": 10000 },
{ "id": "enterprise", "name": "Enterprise", "price": 49, "requests_per_month": -1 }
]
}Upgrade your account to a higher plan. Requires the target plan ID in the request body.
curl -X POST https://www.1tempmail.com/api/v1/upgrade \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"plan_id": "pro"}'
# Response
{
"plan": "pro",
"requests_limit": 10000,
"effective_at": "2026-07-07T10:00:00Z",
"checkout_url": "https://www.1tempmail.com/checkout/..."
}Start free and scale as you grow. No hidden fees.