AI agent이 일회용 이메일 수신함을 생성하고, 메시지를 읽으며, 회원가입 절차를 위한 인증 코드를 자동으로 추출할 수 있도록 지원합니다.
다른 이름 blockonomics/emptyinbox-me, emptyinbox-mcp
- 스타
- 4
- Tools
- 11
- 다운로드, 30일
- —
- 최신 버전
- 1.5.0
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- —
EmptyInbox MCP란?
AI agent이 일회용 이메일 수신함을 생성하고, 메시지를 읽으며, 회원가입 절차를 위한 인증 코드를 자동으로 추출할 수 있도록 지원합니다. 11개 도구를 제공합니다. 예: create_inbox, list_inboxes, list_messages.
프로젝트 README에서 생성된 요약
EmptyInbox MCP server 정보
EmptyInbox는 AI agent가 자동화된 작업을 위해 일회용 이메일 주소를 관리할 수 있는 방법을 제공합니다. 이 MCP server를 사용하면 agent가 새로운 수신함을 생성하고, 수신된 메시지를 읽으며, 인증 코드나 액션 링크와 같은 특정 데이터를 추출할 수 있습니다. 사람의 개입 없이도 회원가입 절차와 일회용 비밀번호(OTP) 요구 사항을 처리하도록 설계되었습니다.
Claude Code를 통해 설정하거나 표준 MCP client 설정에 npx 명령어를 추가하여 사용할 수 있습니다. 서버는 첫 번째 tool call 중에 계정 등록을 자동으로 처리하며, 자격 증명을 로컬 JSON 파일에 저장합니다. 개발자는 환경 변수를 통해 직접 API key를 제공할 수도 있습니다. 이 시스템에는 번들 목록 확인, Bitcoin을 통한 할당량 구매, 결제 상태 확인 등 계정 크레딧을 관리하는 tool이 포함되어 있습니다. 수신함은 기본적으로 30일 후에 만료되지만, keep_inbox tool을 사용하면 비밀번호 재설정과 같은 장기적인 용도로 주소를 영구적으로 유지할 수 있습니다.
활용 사례
- 1이메일에서 인증 코드 추출수신된 메시지를 파싱하여 특정 OTP 코드나 액션 링크를 가져올 수 있습니다.
- 2Bitcoin을 이용한 서비스 크레딧 관리agent가 결제 URL을 생성하고 트랜잭션 확정 여부를 확인하여 할당량 구매를 지원할 수 있습니다.
- 3영구 이메일 주소 유지개발자가 수신함 만료를 방지하여 향후 비밀번호 재설정 이메일을 받을 수 있도록 설정할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
EmptyInbox MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 EmptyInbox MCP 설치
$ claude mcp add --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox -- npx -y emptyinbox-mcpCursor에 EmptyInbox MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}VS Code에 EmptyInbox MCP 설치
.vscode/mcp.json
{
"servers": {
"emptyinbox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}VS Code CLI에 EmptyInbox MCP 설치
$ code --add-mcp '{"name":"emptyinbox","type":"stdio","command":"npx","args":["-y","emptyinbox-mcp"],"env":{"EMPTYINBOX_API_KEY":"<YOUR_EMPTYINBOX_API_KEY>"}}'Claude Desktop에 EmptyInbox MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}Codex에 EmptyInbox MCP 설치
$ codex mcp add emptyinbox --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' -- npx -y emptyinbox-mcpCodex config.toml에 EmptyInbox MCP 설치
~/.codex/config.toml
[mcp_servers.emptyinbox] command = "npx" args = ["-y", "emptyinbox-mcp"] [mcp_servers.emptyinbox.env] EMPTYINBOX_API_KEY = "<YOUR_EMPTYINBOX_API_KEY>"
Gemini CLI에 EmptyInbox MCP 설치
$ gemini mcp add -s user -e 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox npx -- -y emptyinbox-mcpGemini settings.json에 EmptyInbox MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}EmptyInbox MCP 도구 11
README에서 감지됨create_inboxlist_inboxeslist_messagesget_messagewait_for_messageget_quotalist_bundlesbuy_quotacheck_paymentkeep_inboxreport_issue
| create_inbox | — | |
| list_inboxes | — | |
| list_messages | — | |
| get_message | — | |
| wait_for_message | — | |
| get_quota | — | |
| list_bundles | — | |
| buy_quota | — | |
| check_payment | — | |
| keep_inbox | — | |
| report_issue | — |
구성
EMPTYINBOX_API_KEY비밀Existing EmptyInbox API key. Omit to auto-register a free account on the first tool call that needs one; the key is then written to ~/.emptyinbox.json.
| 이름 | 설명 | 유형 |
|---|---|---|
| EMPTYINBOX_API_KEY | Existing EmptyInbox API key. Omit to auto-register a free account on the first tool call that needs one; the key is then written to ~/.emptyinbox.json. | 비밀 |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기emptyinbox-mcp
MCP server for EmptyInbox — create disposable email inboxes and read messages from AI agents.
Listed in the official MCP Registry as io.github.cnohall/emptyinbox.
Setup
Claude Code:
claude mcp add emptyinbox -- npx -y emptyinbox-mcp@latest
Any other MCP client — add to its config:
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": ["-y", "emptyinbox-mcp@latest"]
}
}
}
No setup: the first tool call that needs an account registers one automatically and saves the key to ~/.emptyinbox.json for future sessions. Starting the server on its own (as MCP hosts do to list tools) creates nothing.
Bring your own account (optional — to reuse an existing key):
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": ["-y", "emptyinbox-mcp@latest"],
"env": {
"EMPTYINBOX_API_KEY": "your_api_key_here"
}
}
}
}
Get an API key at https://emptyinbox.me/settings.html
Tools
| Tool | Description |
|---|---|
create_inbox |
Create a new email address; it expires after 30 days unless kept |
list_inboxes |
List all inboxes on your account |
list_messages |
List received messages, each with its extracted code, action link and text preview |
get_message |
Get one message parsed (code, links, plain text), or format="text" for a flat rendering |
wait_for_message |
Block until an email arrives — perfect for signup/OTP flows; returns the extracted code with it |
get_quota |
Credits remaining on the account |
list_bundles |
List quota bundles and prices |
buy_quota |
Quote a Bitcoin payment; returns a pay_url for the user plus address, amount and BIP21 URI |
check_payment |
Check whether a payment landed and quota was credited |
keep_inbox |
Make an inbox permanent (30 credits) so it keeps receiving mail, e.g. password resets |
report_issue |
Send a bug, payment problem, docs gap or feature request to the team; never creates an account |
Example agent workflow
1. create_inbox → "clever.sunny.butterfly@emptyinbox.me"
2. [agent signs up to some service using that address]
3. wait_for_message(inbox="clever.sunny.butterfly@emptyinbox.me", timeout_seconds=60)
4. → returns the verification email with code/link
Payment
Every account starts with free inboxes. When they run out, create_inbox returns
the prices and the agent can close the purchase without leaving the session:
- the agent shows its user the bundles and the user picks one
buy_quotareturns apay_url— a page with a QR code, the exact amount and live status — plus the raw address, amount and BIP21 URI- the user pays from any Bitcoin wallet (or an agent with its own wallet pays the BIP21 URI)
check_paymentwithwait_secondsconfirms the credit, usually within seconds of broadcast
buy_quota takes either a bundle id from list_bundles or a custom whole-dollar
usd amount from $1 to $100, for an agent spending down whatever a wallet holds.
A custom amount is priced at the best bundle rate it qualifies for. The network
fee the payer adds on top is the same whatever the size of the payment, so it
eats a far larger share of a dollar-sized top-up.
Quota is granted as soon as the payment is seen on the network, so there is no waiting for confirmations. Humans can also buy at https://emptyinbox.me/inboxes.html
EmptyInbox MCP 질문
EmptyInbox MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox -- npx -y emptyinbox-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
EmptyInbox MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
EmptyInbox MCP는 어떤 도구를 제공하나요?
11개 도구를 제공합니다. 예: create_inbox, list_inboxes, list_messages, get_message, wait_for_message.
EmptyInbox를 어떻게 설정하나요?
이 MCP server는 별도의 수동 설정이 필요하지 않습니다. 계정이 필요한 첫 번째 tool call이 실행될 때 자동으로 계정을 등록하고 키를 로컬에 저장합니다.
agent가 인증 코드를 어떻게 처리하나요?
wait_for_message tool은 이메일이 도착할 때까지 대기할 수 있어, 추출된 코드를 반환함으로써 회원가입이나 OTP 절차를 처리하기에 이상적입니다.
할당량을 추가하려면 결제를 어떻게 하나요?
agent가 buy_quota를 통해 Bitcoin 결제를 안내할 수 있으며, 사용자는 제공된 결제 URL과 BIP21 URI를 통해 트랜잭션을 완료할 수 있습니다.