{
  "markdown": "# MCP Server - Temporary Email\n\nAn MCP (Model Context Protocol) server for temporary email management using the ChatTempMail API.\n\n[中文文档](./README-zh.md)\n\n## Features\n\n### Email Management\n- ✅ Get available domains\n- ✅ Create temporary emails\n- ✅ List emails\n- ✅ Delete emails\n\n### Message Management  \n- ✅ Get email messages\n- ✅ View message details\n- ✅ Delete messages\n\n### Webhook Configuration\n- ✅ Get webhook configuration\n- ✅ Set webhook configuration\n\n## Installation and Usage\n\n### 1. Get API Key\n\n1. Visit [chat-tempmail.com](https://chat-tempmail.com)\n2. Register an account and login\n3. Create an API key in your profile page\n\n### 2. Configure MCP Client\n\nAdd the configuration to your MCP client (Claude Desktop, Cursor, etc.), **make sure to set the API key in environment variables**:\n\n**Install from source:**\n```json\n{\n  \"mcpServers\": {\n    \"tempmail\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/Selenium39/mcp-server-tempmail.git\",\n        \"mcp-server-tempmail\"\n      ],\n      \"env\": {\n        \"TEMPMAIL_API_KEY\": \"your-api-key-here\",\n        \"TEMPMAIL_BASE_URL\": \"https://chat-tempmail.com\"\n      }\n    }\n  }\n}\n```\n\n**Install from package manager:**\n```json\n{\n  \"mcpServers\": {\n    \"tempmail\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-server-tempmail\"],\n      \"env\": {\n        \"TEMPMAIL_API_KEY\": \"your-api-key-here\",\n        \"TEMPMAIL_BASE_URL\": \"https://chat-tempmail.com\"\n      }\n    }\n  }\n}\n```\n\n⚠️ **Important:** \n- Replace `your-api-key-here` with your actual API key from chat-tempmail.com\n- `TEMPMAIL_BASE_URL` is optional and defaults to `https://chat-tempmail.com` if not specified\n\n### 3. Restart Application\n\nRestart your MCP client application after configuration.\n\n## MCP Tools Documentation\n\n### Email Management Tools\n\n#### `get_email_domains`\nGet all available email domains in the system.\n\n**Parameters:** None\n\n#### `create_email`  \nCreate a new temporary email address.\n\n**Parameters:**\n- `name` (required): Email prefix name\n- `domain` (required): Email domain\n- `expiryTime` (required): Expiry time in milliseconds, options:\n  - `3600000` - 1 hour\n  - `86400000` - 1 day  \n  - `259200000` - 3 days\n  - `0` - permanent\n\n#### `list_emails`\nGet all email addresses under your account.\n\n**Parameters:**\n- `cursor` (optional): Pagination cursor\n\n#### `delete_email`\nDelete the specified email address.\n\n**Parameters:**\n- `emailId` (required): Email ID\n\n### Message Management Tools\n\n#### `get_messages`\nGet all messages in the specified email address.\n\n**Parameters:**\n- `emailId` (required): Email ID\n- `cursor` (optional): Pagination cursor\n\n#### `get_message_detail`\nGet detailed content of the specified message.\n\n**Parameters:**\n- `emailId` (required): Email ID\n- `messageId` (required): Message ID\n\n#### `delete_message`\nDelete the specified message.\n\n**Parameters:**\n- `emailId` (required): Email ID\n- `messageId` (required): Message ID\n\n### Webhook Configuration Tools\n\n#### `get_webhook_config`\nGet current webhook configuration information.\n\n**Parameters:** None\n\n#### `set_webhook_config`\nSet or update webhook configuration.\n\n**Parameters:**\n- `url` (required): Webhook URL address\n- `enabled` (required): Whether to enable webhook\n\n## Usage Examples\n\n### Get Available Domains\n\n```\nPlease get all available email domains.\n```\n\n### Create Temporary Email\n\n```\nPlease create an email named \"test\" using domain \"chat-tempmail.com\" with 1 hour validity.\n```\n\n### View Email Messages\n\n```\nPlease view all messages in email ID \"c2c4f894-c672-4d5b-a918-abca95aff1f7\".\n```\n\n### View Message Details\n\n```  \nPlease view the detailed content of message ID \"fd13a8df-1465-4fbc-a612-ca7311c31ff2\" in email ID \"c2c4f894-c672-4d5b-a918-abca95aff1f7\".\n```\n\n## Notes\n\n- API key is configured through the `TEMPMAIL_API_KEY` environment variable, please keep it secure and do not expose it publicly\n- Base URL can be customized through the `TEMPMAIL_BASE_URL` environment variable (defaults to `https://chat-tempmail.com`)\n- Temporary emails will automatically expire according to the set expiry time\n- Use `nextCursor` for paginated queries to get more data\n- Make sure to set the environment variables correctly in your MCP client configuration\n\n## License\n\nMIT\n\n## Contributing\n\nIssues and Pull Requests are welcome.",
  "bytes": 4302,
  "sha": "da2588b6497b15dab85679eb21b0f74abc7f5ad679ca73fdeff84722b66bdc6b",
  "repo_slug": "selenium39/mcp-server-tempmail",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_selenium39_mcp_server_tempmail_2956385b/readme"
}