@1tempmail/mcp-server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@1tempmail/mcp-serverGenerate a temporary email address"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@1tempmail/mcp-server
MCP Server for 1TempMail — Generate temporary emails, check inboxes, and read messages via AI assistants.
Install
npm install -g @1tempmail/mcp-serverOr use directly with npx (no install needed):
npx -y @1tempmail/mcp-serverRelated MCP server: MCP Server - Temporary Email
Get Your API Key
Sign in with Google
Click "Generate API Key"
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 a new temporary email address (active for 60 minutes) |
| Retrieve all messages in the inbox for a given session token |
| Retrieve the full content of a specific message |
Environment Variables
Variable | Required | Default | Description |
| Yes | — | Your 1TempMail API key |
| No |
| API base URL |
License
MIT
Available Tools
3 toolscheck_inboxA
Retrieve all messages currently in the inbox for a given temporary email address.
| Name | Required | Description | Default |
|---|---|---|---|
| sid_token | Yes | The session token returned by generate_email. |
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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.
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.
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.
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.
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.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| sid_token | Yes | The session token returned by generate_email. | |
| message_id | Yes | The message ID from check_inbox. |
TDQS
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.
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.
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.
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.
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.
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.
3 tool updates
v1.0.0- First observed
check_inbox - First observed
generate_email - First observed
get_message
TDQS
Each tool has a clear, distinct purpose: generate_email creates addresses, check_inbox lists messages, get_message retrieves details. No overlapping functionality.
All tools follow a consistent verb_noun pattern (generate_email, check_inbox, get_message), making them predictable and easy to understand.
Three tools are appropriate for a temporary email service, covering the essential operations (create, list, read) without unnecessary bloat.
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
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
Disposable inboxes for AI agents: create, wait for delivery, and extract email content or links.
Disposable email inboxes for AI agents — read messages and verification codes.
Task-scoped email inboxes for AI agents: read mail, extract verification codes, and reply.
Real email inboxes for AI agents: create inboxes, catch verification codes, extract OTPs, reply.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables creating temporary email inboxes and sending emails through the AgentMail API, allowing AI agents to manage email communications programmatically.1-
- AlicenseAqualityDmaintenanceManages temporary email addresses via the ChatTempMail API, supporting creation, listing, and deletion of emails and messages, as well as webhook configuration.99710MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage temporary email addresses via the mail.tm API, including creating disposable inboxes, reading messages, and managing accounts.MIT
- AlicenseAqualityFmaintenanceEnables AI agents to create temporary email addresses, receive confirmation emails, and extract verification links, automating sign-up and email verification workflows without manual intervention.63261MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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