Your Shield Against Spam & For Your Online Privacy

Temp Mail API & MCP Server

Free disposable email API for developers. Generate temp emails, check inboxes, and read messages programmatically via REST API or MCP Server.

REST API MCP Protocol Bearer Auth JSON Responses

Quick Start

Get up and running in under a minute. Sign in with your Google account to get your API key, then start making requests.

Sign In & Get Your API Key

Click "Continue with Google" above to sign in. Once signed in, click "Generate API Key" to create your API key instantly.

Generate a Temp Email

curl -X POST https://www.1tempmail.com/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY"

Account & API Key

Sign in with your Google account to manage your API key and access dashboard features.

By continuing, you agree to our Terms of Service and Privacy Policy.

Authentication

All API requests require a Bearer token in the Authorization header. Sign in with your Google account above and generate an API key to get started.

🔒
Bearer Token Auth

Include your API key in every request:

Authorization: Bearer your_api_key_here

Keep Your API Key Secret

Never expose your API key in client-side code or public repositories. Store it in environment variables or a secrets manager.

MCP Server Tools

The 1TempMail MCP Server exposes six tools that AI assistants can call directly. Connect via the MCP endpoint at https://www.1tempmail.com/mcp. Standard tools are available on all plans; EDU tools require the Pro plan.

Tool generate_email

Generate a new temporary email address. The email remains active for 60 minutes and can receive messages during that time.

Parameters

None.

Example Response

{
  "email": "abc123@1tempmail.com",
  "sid_token": "sid_a8f3c2d1e4b56790",
  "expires_in": "60 minutes",
  "hint": "Use check_inbox with the sid_token to read incoming emails."
}

Tool check_inbox

Retrieve all messages currently in the inbox for a given temporary email address.

Parameters

Parameter Type Required Description
sid_token string required The session token returned by generate_email.

Example Response

{
  "count": 1,
  "emails": [
    {
      "id": "msg_01HZ3QK7M8NP",
      "from": "noreply@example.com",
      "subject": "Verify your email address",
      "excerpt": "Your verification code is 482917...",
      "timestamp": "2026-07-07T10:30:00Z"
    }
  ]
}

Tool get_message

Retrieve the full content of a specific message, including the body text.

Parameters

Parameter Type Required Description
sid_token string required The session token returned by generate_email.
message_id string required The message ID from check_inbox.

Example Response

{
  "id": "msg_01HZ3QK7M8NP",
  "from": "noreply@example.com",
  "subject": "Verify your email address",
  "body": "Your verification code is 482917...",
  "timestamp": "2026-07-07T10:30:00Z"
}
EDU Email Tools — Pro Plan Required

The three tools below operate on .edu.kg mailboxes with a 7-day validity window. They require a Pro or Enterprise API key; Free keys calling them receive error -32003.

Pro generate_edu_email

Generate a new temporary EDU email address on the .edu.kg domain. The mailbox stays active for 7 days; individual messages expire after 24 hours. Accepted by many educational platforms and student discount services. Returns a token and view_token pair — keep both, they are required for all subsequent EDU calls.

Parameters

None.

Example Response

{
  "email": "a8f3c2d1@cpu.edu.kg",
  "token": "mbx_a8f3c2d1e4b56790",
  "view_token": "vw_9k2m7x4q1p6z3r8w5",
  "domain": "cpu.edu.kg",
  "is_edu": true,
  "expires_at": "2026-07-20T10:30:00Z",
  "expires_in": "7 days",
  "message_retention": "24 hours",
  "hint": "Use check_edu_inbox with token and view_token to read incoming emails."
}

Pro check_edu_inbox

Retrieve all messages in the inbox of an EDU temporary email address.

Parameters

Parameter Type Required Description
token string required The mailbox token returned by generate_edu_email.
view_token string required The view token returned by generate_edu_email. Required to read messages.

Example Response

{
  "count": 1,
  "emails": [
    {
      "id": "msg_9k2m7x4q",
      "from_addr": "noreply@studentplatform.com",
      "subject": "Confirm your student email",
      "timestamp": "2026-07-13T14:22:00Z"
    }
  ]
}

Pro get_edu_message

Retrieve the full content of a specific EDU email message, including the body text and sanitized HTML.

Parameters

Parameter Type Required Description
token string required The mailbox token returned by generate_edu_email.
view_token string required The view token returned by generate_edu_email.
message_id string required The message ID from check_edu_inbox.

Example Response

{
  "id": "msg_9k2m7x4q",
  "from_addr": "noreply@studentplatform.com",
  "subject": "Confirm your student email",
  "body": "Welcome! Click the link below to verify...",
  "html": "<div>Welcome! <a href=...>Verify</a></div>",
  "timestamp": "2026-07-13T14:22:00Z"
}

JSON-RPC call shape

All tools are invoked via a single POST /mcp request with JSON-RPC 2.0 body. The tool result is wrapped as a JSON string inside result.content[0].text — parse it to get the structured payload shown above. The response also carries _meta.remaining showing remaining monthly quota.

curl -X POST https://www.1tempmail.com/mcp \
  -H "Authorization: Bearer 1tm_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_edu_email","arguments":{}}}'

MCP Integration

Add the 1TempMail MCP Server to your AI tool by adding the configuration below to your settings file. The server is open source — view the source, report issues, or contribute on GitHub:

Source Code

The 1TempMail MCP Server is open source on GitHub:

github.com/haskx/1tempmail-mcp-server

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"
      }
    }
  }
}

Remote MCP Endpoint

If your tool supports remote MCP servers via SSE, you can also connect directly:

https://www.1tempmail.com/mcp

REST API Reference

Base URL: https://www.1tempmail.com/api/v1

POST

/generate-key

Generate a new API key. Requires an active login session (sign in with Google first).

curl -X POST https://www.1tempmail.com/api/v1/generate-key \
  -H "Cookie: better-auth.session_token=..."

# Response
{
  "api_key": "tmp_live_k8x...qz2",
  "plan": "free",
  "quota_limit": 10
}
GET

/usage

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": 3,
  "requests_limit": 10,
  "period_end": "2026-08-01T00:00:00Z"
}
GET

/plans

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": 10, "status": "active" },
    { "id": "pro", "name": "Pro", "price": 9, "requests_per_month": 1000, "status": "active" },
    { "id": "enterprise", "name": "Enterprise", "price": 49, "requests_per_month": "unlimited", "status": "coming_soon" }
  ]
}
POST

/upgrade

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/..."
}

Pricing Plans

Start free and scale as you grow. No hidden fees.

Free
$0 /mo
10 requests / month
  • Temp email generation
  • Inbox checking
  • Message reading
  • 60-minute email lifetime
Get Started Free
Pro
$9 /mo
1,000 requests / month
  • Everything in Free
  • Higher request quota
  • Email support
Upgrade to Pro
Enterprise
Coming Soon
Custom solutions for teams
  • Everything in Pro
  • Unlimited API calls
  • Dedicated infrastructure
  • SLA guarantee
  • Dedicated account manager

Temp Mail API FAQ

Is the 1TempMail API free to use?

Yes, the 1TempMail API offers a free plan with 10 requests per month at no cost. You can generate temporary emails, check inboxes, and read messages without a credit card. For higher usage, the Pro plan offers 1,000 requests per month for $9.

How do I get a temp mail API key?

To get a temp mail API key, sign in with your Google account on the API documentation page, then click "Generate API Key". Your key is instantly created and can be used in the Authorization header as a Bearer token for all API requests.

What is the MCP Server for temp mail?

The 1TempMail MCP Server is a Model Context Protocol server that lets AI assistants like Claude Code and Cursor generate temporary emails, check inboxes, and read messages directly. You can connect via the endpoint https://www.1tempmail.com/mcp or install the npm package @1tempmail/mcp-server. See the MCP Integration section above for configuration details.

Can I use the temp mail API for software testing?

Yes, the temp mail API is ideal for software testing. Developers can programmatically generate disposable emails to test signup flows, email verification, OTP delivery, and notification systems without polluting real inboxes. It integrates easily with Playwright, Selenium, and Cypress test pipelines. Read our developer's guide to disposable email for testing for detailed workflows.

What are the API rate limits for temp mail?

The free plan includes 10 API requests per month, while the Pro plan offers 1,000 requests per month for $9. The Enterprise plan with unlimited requests is coming soon. Usage resets at the end of each billing period, and you can monitor your remaining quota via the /usage endpoint.

How long do temporary emails last?

Standard temporary emails generated via the API remain active for 60 minutes. EDU emails on the .edu.kg domain (Pro plan only) stay active for 7 days with individual messages expiring after 24 hours.

Roadmap & Upcoming Features

Here's what we're working on next. These features are planned but not yet implemented.

PlannedCustom Domains

Bring your own domain to generate temporary emails with your brand. Pro and Enterprise plans.

PlannedExtended Email Lifetime

Extend email validity beyond 60 minutes — up to 24 hours or 7 days for Pro users.

PlannedPriority Delivery

Faster inbox polling and email delivery for Pro and Enterprise users.

PlannedWebhook Notifications

Get notified via webhook when a new email arrives, instead of polling the inbox.

PlannedEmail Forwarding

Automatically forward received emails to your personal inbox.

PlannedTeam Management & Enterprise SSO

Manage multiple API keys, team members, and SAML SSO for Enterprise organizations.

PlannedAnalytics Dashboard

Detailed usage analytics, request logs, and billing history in your account dashboard.

Sponsored
Sponsored