Skip to main content
Glama
haskx

@1tempmail/mcp-server

by haskx

@1tempmail/mcp-server

MCP Server for 1TempMail — Generate temporary emails, check inboxes, and read messages via AI assistants.

Install

npm install -g @1tempmail/mcp-server

Or use directly with npx (no install needed):

npx -y @1tempmail/mcp-server

Related MCP server: MCP Server - Temporary Email

Get Your API Key

  1. Visit https://www.1tempmail.com/api/

  2. Sign in with Google

  3. Click "Generate API Key"

  4. Copy your API key

Configuration

Set the 1TEMPMAIL_API_KEY environment variable:

export 1TEMPMAIL_API_KEY="your_api_key_here"

Usage with AI Tools

Claude Code

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

Cursor

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

Other MCP-Compatible Tools (Windsurf, Cline, etc.)

Add the same server config to your tool's MCP settings file.

Tools

Tool

Description

generate_email

Generate a new temporary email address (active for 60 minutes)

check_inbox

Retrieve all messages in the inbox for a given session token

get_message

Retrieve the full content of a specific message

Environment Variables

Variable

Required

Default

Description

1TEMPMAIL_API_KEY

Yes

Your 1TempMail API key

1TEMPMAIL_API_BASE

No

https://www.1tempmail.com

API base URL

License

MIT

Available Tools

3 tools
check_inboxA

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

ParametersJSON Schema
NameRequiredDescriptionDefault
sid_tokenYesThe session token returned by generate_email.

TDQS

A3.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It only says 'retrieve' without disclosing behavioral traits such as whether messages are deleted after retrieval, pagination behavior, rate limits, or error scenarios.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence that front-loads the action and context. Every word is necessary and there is no redundancy or extraneous information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (one parameter, no output schema), the description covers the essential purpose. However, it omits details like whether messages are marked as read or if the inbox is cleared, which could be important for an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema coverage is 100% and the parameter description in the schema already explains the sid_token. The tool description adds no additional meaning beyond that, which is acceptable given the schema's completeness.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('retrieve all messages'), the resource ('inbox'), and the context ('for a given temporary email address'). It distinguishes from siblings: generate_email creates an address and get_message retrieves a specific message.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied (after generating email, before getting a message), but there is no explicit guidance on when to use versus alternatives or when not to use. No exclusions or prerequisites are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

generate_emailA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. It discloses that the email lasts 60 minutes and can receive messages, which are key behavioral traits. However, it does not mention any side effects, rate limits, or privacy implications.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the core action, and every sentence adds essential information. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given zero parameters, no annotations, and no output schema, the description covers what the tool does, its duration, and its receive capability. It is sufficient for an agent to understand and invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, so the description fully explains the tool's action. It adds value by describing the lifespan and receive capability beyond the empty schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Generate') and resource ('a new temporary email address'), and adds info that it remains active for 60 minutes and can receive messages. It is distinct from siblings which focus on reading inbox/messages.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies this tool is for creating a temporary email for receiving messages, but does not explicitly state when not to use it or provide alternatives. The context with sibling tools makes the purpose clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_messageA

Retrieve the full content of a specific message, including the HTML body and attachments metadata.

ParametersJSON Schema
NameRequiredDescriptionDefault
sid_tokenYesThe session token returned by generate_email.
message_idYesThe message ID from check_inbox.

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It discloses that the tool retrieves the full content including HTML body and attachments metadata, implying a read-only operation. However, it does not explicitly state that it has no side effects or destructive potential. No contradictions with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-structured sentence that conveys essential information without unnecessary words. It is front-loaded with the verb and resource, making it easy to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (2 required parameters, no output schema, no nested objects), the description is complete. It specifies what the tool returns (HTML body and attachments metadata) and its relationship to sibling tools via context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with both parameters clearly described (sid_token and message_id). The description adds no additional semantic meaning beyond what the schema already provides. Baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Retrieve the full content of a specific message') and the specific resource (message with HTML body and attachments metadata). It distinguishes itself from sibling tools: check_inbox (lists messages) and generate_email (creates email), making the purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage after obtaining a message ID from check_inbox, but it does not explicitly state when to use it versus alternatives or provide any exclusion criteria. There is no guidance on prerequisites or context for invocation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 3 tool updatesv1.0.0
    • First observedcheck_inbox
    • First observedgenerate_email
    • First observedget_message

TDQS

A4.1/5.0
Disambiguation5/5

Each tool has a clear, distinct purpose: generate_email creates addresses, check_inbox lists messages, get_message retrieves details. No overlapping functionality.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern (generate_email, check_inbox, get_message), making them predictable and easy to understand.

Tool Count5/5

Three tools are appropriate for a temporary email service, covering the essential operations (create, list, read) without unnecessary bloat.

Completeness4/5

The set covers core create and read operations but lacks a delete or refresh tool, which could be useful but is not critical given auto-expiry.

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Manages temporary email addresses via the ChatTempMail API, supporting creation, listing, and deletion of emails and messages, as well as webhook configuration.
    9
    97
    10
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to manage temporary email addresses via the mail.tm API, including creating disposable inboxes, reading messages, and managing accounts.
    MIT
  • A
    license
    A
    quality
    F
    maintenance
    Enables AI agents to create temporary email addresses, receive confirmation emails, and extract verification links, automating sign-up and email verification workflows without manual intervention.
    6
    32
    61
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/haskx/1tempmail-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server