# gecici.email — free temporary email API and MCP Create a 60-minute disposable inbox in one HTTPS request, without signup or a global API key. Receive email through REST or hosted MCP; each inbox returns a private token required for reads and deletion. Python and Node clients are available as direct downloads. This is a receive-only service for authorized developer and short-lived agent workflows, not a permanent mailbox or an outbound sender. External delivery is not guaranteed; do not use it for sensitive accounts or real user mail. ## Documentation and interfaces - [Website](https://gecici.email/): Turkish browser inbox. - [English website](https://gecici.email/en/): English browser inbox. - [Remote MCP endpoint](https://gecici.email/mcp): Streamable HTTP tools for compatible clients; no unpublished package required. - [AI agent guide](https://gecici.email/en/agents.html): MCP/REST connection steps, tested browser-use inbox tools and operational limits. - [Tested browser-use tutorial](https://gecici.email/en/agents.html#browser-use): Pinned Python example with real tool dispatch, QA-tagged API simulation, code extraction and cleanup; no browser/LLM signup test claimed. - [Free temporary email API](https://gecici.email/en/api.html): First HTTP request, response fields, Python/Node setup, matched verification and limits. - [Full integration reference](https://gecici.email/llms-full.txt): Detailed machine-readable documentation. - [Public client examples](https://github.com/codeonthetable/gecici-email): Integration examples, not the production server source. - [Privacy and retention](https://gecici.email/en/privacy.html): Storage, token handling, analytics and deletion limits. - [MCP quickstart source](https://gecici.email/examples/mcp-quickstart.py): Standard-library QA example; create, read and delete through MCP. ## MCP tools - `gecici_wait_for_verification`: preferred matched read; address, token and since (Unix milliseconds) required. Sender/subject filters, OTP or HTTPS link, ready/pending/ambiguous/blocked states. Link/either mode requires expected_link_host. Returns no raw email body. - `gecici_delete_inbox`: delete an active inbox and its messages with its address and token after your test. - gecici_create_inbox: creates a test inbox; returns address, access token, and expiry. - gecici_wait_for_otp: reads an extracted code, if available; requires address and token. - gecici_wait_for_magic_link: reads an extracted verification URL, if available; requires address and token; does not open the link. - gecici_get_inbox_messages: lists messages; requires address and token. - gecici_get_ai_summary: reads the latest summary; requires address and token. Usage: create an inbox, retain its token privately, use its address only in an authorized workflow, then query with the token. Empty inboxes and extraction failures must not be presented as successful verification. Never send the token to third-party sites or place it in prompts shared publicly. Storage: The web API stores inbox metadata, access tokens, and messages in a server-side SQLite database. Default inbox life is 60 minutes, extendable by the holder of the token. Expired records are logically deleted during API requests; physical erasure from disk, backups, or infrastructure logs is not guaranteed. This is not a zero-log or RAM-only service. ## Tested application verification - [Email verification testing](https://gecici.email/en/email-verification-testing.html): Runnable Python fixture, real Chrome form, wrong-code rejection, verified state, replay rejection and cleanup. Hosted API simulation; no SMTP or LLM-agent test claimed. - [Türkçe doğrulama rehberi](https://gecici.email/yazilim-test-epostasi): Kendi test uygulamasında geçici kutudan form doğrulamasına kadar çalıştırılan akış. ## Practical guides — 14 November 2026 - [Guide index](https://gecici.email/en/guides.html): delivery troubleshooting, Playwright and Cursor workflows; [Turkish](https://gecici.email/rehberler.html). - [Playwright email verification](https://gecici.email/en/playwright-email-verification.html): tested Chromium + local Python form + hosted QA inbox. Message transport simulated, no external SMTP or model test. - [Cursor MCP connection](https://gecici.email/en/cursor-temporary-email-mcp.html): project configuration, token handling, tool errors and REST cleanup. Hosted API contract tested; Cursor desktop workflow not tested. - [Temporary email not receiving](https://gecici.email/en/temporary-email-not-receiving.html): distinguish sender rejection, expired inbox, delivery and extraction outcomes. - [Matched verification example](https://gecici.email/examples/mcp-verification.py): one-call code/link extraction, filters, ambiguity handling and cleanup; fictional QA simulation only. ## First application verification task - Setup and steps: https://gecici.email/en/agents.html#first-task (TR: https://gecici.email/ai-ajanlar#first-task). - Reviewed-source download: https://gecici.email/examples/agent-first-task.py . Python3.9+ standard library. --run checks MCP extraction and independent local HTTP application acceptance; --serve lets a connected agent perform the task. - The fixture creates a QA-labelled inbox, inserts simulated mail, checks a one-use120second application challenge and deletes the inbox. Only fixed stage outcomes are printed. Tokens, addresses and codes stay in runtime memory. - --run is deterministic, not a model test. A supervised Codex connected-tool run passed17Nov2026; external SMTP, arbitrary signup, Claude/Cursor model completion and real adoption are not established. ## Installable Python client 1.2.0 - [Python SDK setup and API](https://gecici.email/downloads/python/README.md): core REST inbox lifecycle and hosted MCP matched verification. Direct wheel/source distribution; not published on PyPI. - Install with `python -m pip install -r https://gecici.email/downloads/python/requirements.txt` (wheel SHA256 pinned). Python 3.9+; tested with Python 3.12. - Token-redacted representations, bounded read/delete retries, explicit cleanup errors, ready/pending/ambiguous/blocked outcomes. Use `GeciciEmail(qa=True)` for your own tests. No acquired-user, external SMTP or framework compatibility claim. ## Node.js / TypeScript client 1.2.0 - [Node SDK setup and API](https://gecici.email/downloads/typescript/README.md): installable core client with TypeScript source/declarations; no runtime dependencies. Direct download, not an npm registry publication. - Install with `npm install https://gecici.email/downloads/typescript/gecici-email-1.2.0.tgz`; retain the generated lockfile. Node22+ metadata; tested on Node24. CommonJS, ESM named imports and a strict TypeScript consumer verified. - Matched verification, finite request/body deadlines, bounded read/delete retries and explicit cleanup errors. Inbox/result inspection and JSON serialization redact private values. Use `{ qa: true }` for own tests. No external SMTP, model completion or acquired-user claim.