gecici.email

Kotak masuk sementara hanya untuk menerima pesan untuk QA yang berwenang. Buat kotak masuk dan baca pesan, kode verifikasi, serta tautan menggunakan token khusus untuk setiap kotak masuk.

Server MCP Terhosting

npx add-mcp 'https://gecici.email/mcp'

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

Temporary email for AI agents

Create a receive-only inbox for development or QA work you are authorized to perform. Read messages, extracted verification codes, and links using the access token returned at creation. Never put the token in a prompt, public log, or repository.

Hosted MCP endpoint

https://gecici.email/mcp is the hosted HTTP MCP endpoint. Configure it as a remote MCP server in a compatible client. Client setup varies; availability in a particular AI product is not guaranteed.

The tools support inbox creation and token-protected message and verification retrieval. Keep the address and token together in your agent's secure runtime state.

TESTED GUIDE · 25 October 2026

Test temporary email and verification-code tools with browser-use

An agent testing your application's email verification needs to create an inbox, read the incoming code, and delete the inbox when finished. This example registers those three operations as browser-use tools. The bearer token stays inside the Python helper; the agent receives the address and code needed by your form.

The check below dispatches real tools against the hosted API and adds a fictional message through the simulation endpoint. It does not launch a browser, call a language model or use an external email sender. Passing it does not prove that a website signup was completed.

1. Install the tested revision

Use Python 3.11 or later and start in a new directory. No model key or separate gecici-email Python package is required for this check.

git clone https://github.com/codeonthetable/gecici-email.git
cd gecici-email
git checkout 4951b8f041b8ebe9b98282dacbc4c2d262b711b5
python3 -m venv .venv
source .venv/bin/activate
python -m pip install 'browser-use==0.13.11'
python -m unittest discover -s tests -v
python examples/browser_use_inbox.py --qa-run

On Windows, activate with .venv\Scripts\activate. The pinned Git revision downloads the code used for the results below. Review the example source before running it.

2. Understand the result

With Python 3.12.14 and browser-use 0.13.11, 16 local tests passed; the separate opt-in live MCP test was skipped. The hosted API check returned these fields as true. It prints no addresses, tokens, messages or codes.

create_action_passed: true

The tool created a temporary inbox.

token_not_returned: true

The create tool's result did not contain the bearer token.

otp_action_matched: true

The extracted code matched the fictional message inserted by the test.

cleanup: true

The disposable inbox was deleted after the check.

Requests carry the qa-test label. This demonstration is excluded from normal usage; it is not a real user or successful AI-use count. Empty inboxes and timeouts are not successful verification.

3. Connect your own application's test flow

  1. Create a fresh InboxTools(qa=True) for each run and add the tools to your existing agent with register(Tools()).
  2. Ask the agent to call gecici_create_inbox and enter the returned address into your test form. Keep the bearer token out of the form.
  3. After your application sends its message, call gecici_wait_for_otp with a timeout from 1 to 45 seconds. Enter the received code and check your application's explicit success state.
  4. Call gecici_delete_inbox and also use await inbox.close() in your runner's finally block.

This adaptation needs your actual test application URL, a browser setup and a configured model. The full model-and-form workflow has not been tested for this guide. Your model can see the address and code, so use fictional test data and review your agent's history settings.

Agent integration code and test details →

No code arrived: what to check

ResultNext check
Deadline reachedCheck your application's send result and delivery delay. Do not mark the form verified before a code arrives.
Inbox action failedCheck connectivity, expiry and parameters. Use a fresh helper for a new run.
Deletion failedRetry await inbox.close() on the same helper. Failed deletion keeps the token in memory for retry.

The tools follow browser-use's custom-tool API. This example is published in the gecici.email repository; it does not imply browser-use endorsement or an accepted upstream contribution.

REST and MCP API guide · Türkçe rehber

Get the right verification result in one call

gecici_wait_for_verification waits for a matching message and extracts its code, HTTPS link, or both. It returns a small structured result instead of the email body. Use a fresh inbox for each test, then pass its createdAt as since.

{
  "name": "gecici_wait_for_verification",
  "arguments": {
    "address": "<created inbox>",
    "token": "<inbox token>",
    "since": 0,
    "kind": "either",
    "sender": "qa@example.invalid",
    "subject_contains": "Verify your email",
    "expected_link_host": "app.example.invalid",
    "timeout_seconds": 15
  }
}

Replace since: 0 with the inbox's actual createdAt Unix milliseconds, and replace the example sender, subject and host with your application's values. For an existing inbox, use the start time of the new verification attempt. Sender and subject filters apply together. Sender matching does not authenticate the email sender.

StateWhat your agent should do
readyUse the extracted value in your authorized application, then check that application's success state.
pendingNo matching supported value yet. Retry within your test's deadline, at most three calls in the example workflow.
ambiguousMultiple codes or allowed links. No value is returned; narrow the test or inspect the template.
blockedLink host/scheme mismatch or a processing limit. Check reason; do not automatically widen the allowed host.

Codes need a supported English or Turkish verification label. Links work in plain text and HTML; link mode requires an exact host and HTTPS. No links are opened. Extraction is deterministic, not a guarantee that a code is valid, a sender is genuine, or an application accepted verification.

Download the self-contained verification example and run python3 mcp-verification.py --run. It tests matching, plain-text links, ambiguous codes, host rejection and cleanup with fictional QA messages. No account or package installation is required. This tests the hosted API, not external SMTP or an LLM. Refresh MCP tool discovery if your client still shows six tools.

REST integration

The REST base is https://gecici.email/api/v1. Create an inbox with POST /inbox/generate or POST /inbox/custom. Then pass Authorization: Bearer <token> when reading, extending, or deleting that inbox.

Read the English API guide.

Check the application result

Run the tested email verification form: a Python application and real Chrome form check wrong codes, verification, reuse rejection and cleanup with a hosted QA inbox. Message transport is simulated; no SMTP or LLM run is claimed.

Downloadable clients

The public GitHub repository provides a runnable client and integration material. It does not provide the private hosted server source. Check the repository's current setup instructions before integrating.

Run your first MCP workflow

Download mcp-quickstart.py and run python3 mcp-quickstart.py --run. It uses Python’s standard library, initializes MCP, creates an inbox, reads a fictional message and deletes the inbox through MCP. No account, global API key or installed package is needed.

This is a QA simulation, not an external email or model test. All requests carry qa-test; addresses, tokens and messages are never printed.

Finish the inbox lifecycle

After reading your test message, call gecici_delete_inbox with that inbox’s address and token. A successful result contains deleted: true. This deletes the active inbox and its messages; it is not a promise of physical erasure from backups or logs.

Successful MCP tools provide both JSON text and structuredContent. Check isError first; empty and timed-out reads are not completed verification.

Operational limits

  • Receive-only; no outbound email.
  • Default inbox lifetime: 60 minutes; token holder may extend or delete.
  • External delivery, verification acceptance, and third-party service behavior are not guaranteed.
  • No CAPTCHA or security-control bypass is provided.