# Disposable Email Address

## Links

- Product page URL: https://www.agentpmt.com/marketplace/disposable-email-address
- Product markdown URL: https://www.agentpmt.com/marketplace/disposable-email-address?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/disposable-email-address?format=agent-json

## Overview

- Product ID: 692dc2eee074f231a45351ca
- Vendor: Apoth3osis
- Type: communications
- Unit type: request
- Price: 1500 credits
- Categories: Data Storage & Persistence, IoT & Automation, System Administration, Project Management, Temporary Email & Verification, Automation
- Generated at: 2026-05-30T20:21:27.974Z

### Page Description

The Temporary Email Service provides disposable email addresses for AI agents to use for account signups and verification workflows. It supports three actions: Create a new temporary email address (24-hour expiration), Check an inbox for messages, List all active email addresses for the authenticated user

For creating and monitoring a temporary, disposable email address inbox. It is designed for AI agents to use for tasks like service registrations and receiving verification links without using a permanent email. Allows cross communication between all agents on the same budget - any one can check the inbox

### Agent Description

Create temporary email addresses (24h expiration), check inboxes, and list active addresses. Shared across agents on same budget.

## Details

### Details

The Temporary Email Service provides disposable email addresses for AI agents to use for account signups and verification workflows. It supports three actions: Create a new temporary email address (24-hour expiration), Check an inbox for messages, List all active email addresses for the authenticated user

For creating and monitoring a temporary, disposable email address inbox. It is designed for AI agents to use for tasks like service registrations and receiving verification links without using a permanent email. Allows cross communication between all agents on the same budget - any one can check the inbox

### Actions

- `create` (15 credits): Create a new temporary disposable email address with a 24-hour expiration. Returns the email address, creation time, and expiration time.
- `check` (15 credits): Check the inbox of a previously created email address and retrieve all messages with full content including sender, subject, body, and received timestamp.
- `fetch` (15 credits): List all active (non-expired) email addresses belonging to the current user, along with creation time, expiration time, and hours remaining for each.

### Use Cases

AI Agent Account Signups, Service Registration, Receiving Verification Links, Automated Testing Workflows, Temporary Communications Channel, Data Privacy Protection, Automated Account Creation, Reading Verification Emails, Processing Inbound Messages, Automated Software Testing, Extracting Data from Emails, Parsing One-Time Passwords (OTPs)

### Workflows Using This Tool

No public workflows currently reference this product.

### Related Content

No related content is currently linked to this product.

## Integration Details

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos

Use the local router for command-based MCP clients. It forwards requests to `https://api.agentpmt.com/mcp` and does not execute tools locally.

```bash
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "692dc2eee074f231a45351ca",
    "parameters": {
      "action": "create"
    }
  }'
```

### Autonomous Agents

Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below.

- Autonomous Agent API reference URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents
- Autonomous Agent API reference markdown URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents?format=agent-md
- Credit-Based Access Using AgentAddress: https://www.agentpmt.com/docs/autonomous-agents/credit-based-tool-usage-with-agentaddress
- AgentAddress is preferred for persistent file access, stored platform state, and maximum tool use ability across repeated calls.
- Direct x402 is for independent one-off tool calls that do not require shared files or stored platform state.
- Direct x402 public payments: USDC on Base, Arbitrum, Optimism, Polygon, and Avalanche.

### Schema

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "create": {
      "description": "Create a new temporary disposable email address with a 24-hour expiration. Returns the email address, creation time, and expiration time.",
      "properties": {
        "username": {
          "type": "string",
          "description": "Preferred username for the email address. If not provided, a random username will be generated. Example: 'myagent' becomes 'myagent@guerrillamail.com'.",
          "required": false
        }
      }
    },
    "check": {
      "description": "Check the inbox of a previously created email address and retrieve all messages with full content including sender, subject, body, and received timestamp.",
      "properties": {
        "email": {
          "type": "string",
          "description": "Email address to check. Must be an email address you previously created with the create action. Example: 'ai_agent_123@guerrillamail.com'.",
          "required": true
        }
      }
    },
    "fetch": {
      "description": "List all active (non-expired) email addresses belonging to the current user, along with creation time, expiration time, and hours remaining for each."
    }
  },
  "properties": {
    "action": {
      "type": "string",
      "description": "Action to perform: 'get_instructions' (retrieve documentation), 'create' (create new email), 'check' (check inbox for messages), or 'fetch' (list all active emails for user)",
      "required": true,
      "enum": [
        "get_instructions",
        "create",
        "check",
        "fetch"
      ]
    },
    "username": {
      "type": "string",
      "description": "Preferred username for email address (create action only, optional). If not provided, a random username will be generated. Example: 'myagent' becomes 'myagent@guerrillamail.com'",
      "required": false
    },
    "email": {
      "type": "string",
      "description": "Email address to check (check action only, required for check). Must be an email address you previously created with the create action. Example: 'ai_agent_123@guerrillamail.com'",
      "required": false
    }
  }
}
```

### Usage Instructions

# Disposable Email Address

Create temporary, disposable email addresses and check their inboxes. Useful for account signups, verification flows, and receiving one-time codes without exposing a real email address.

## Actions

### create

Create a new temporary disposable email address. Addresses are valid for 24 hours.

**Required fields:** None

**Optional fields:**
- `username` (string) - Preferred username for the email address. If omitted, a random username is generated.

**Example:**
```json
{
  "action": "create",
  "username": "myagent"
}
```

**Response includes:** email address, created_at timestamp, expires_at timestamp.

---

### check

Check the inbox of a previously created email address and retrieve all messages with full content.

**Required fields:**
- `email` (string) - The email address to check. Must be an address you previously created with the `create` action.

**Optional fields:** None

**Example:**
```json
{
  "action": "check",
  "email": "myagent@guerrillamail.com"
}
```

**Response includes:** email address, message_count, and a messages array. Each message contains from, subject, body, and received_at.

---

### fetch

List all active (non-expired) email addresses belonging to the current user, along with time remaining for each.

**Required fields:** None

**Optional fields:** None

**Example:**
```json
{
  "action": "fetch"
}
```

**Response includes:** count and an emails array. Each entry contains email, created_at, expires_at, and time_remaining_hours.

---

## Common Workflows

### Sign up for a service and verify the email
1. Use `create` to generate a disposable email address.
2. Use that email address to sign up for the target service.
3. Use `check` with the email address to retrieve the verification code or confirmation link.

### Manage multiple temporary addresses
1. Use `create` multiple times to generate different addresses for different purposes.
2. Use `fetch` to see all your active addresses and how much time remains on each.
3. Use `check` on any specific address to read its messages.

## Important Notes

- Email addresses expire after **24 hours** from creation.
- You can only check inboxes for email addresses you created yourself.
- If no `username` is provided during creation, a random one is assigned automatically.
- Messages are returned with full content including sender, subject, and body.
- Expired email addresses cannot be checked and will not appear in `fetch` results.

### Frequently Asked Questions

#### How do I connect this tool to an external agent?

- Page URL: https://www.agentpmt.com/faq
- Markdown URL: https://www.agentpmt.com/faq?format=agent-md

You can install the local MCP server by opening a terminal and running:

```
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

```
{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}
```

[View MCP Connection Instructions](/docs/mcp-reference/connection) for more details.

#### How does an external agent use this tool?

- Page URL: https://www.agentpmt.com/faq
- Markdown URL: https://www.agentpmt.com/faq?format=agent-md

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

> Call the AgentPMT-Tool-Search-and-Execution tool with action 'get\_schema' and tool\_id 692dc2eee074f231a45351ca ("Disposable Email Address"). Then call the same tool with action 'call\_tool', tool\_id 692dc2eee074f231a45351ca, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

### Dependencies

This product has no public dependency products.