Grades are a hygiene check, not a security guarantee.

MCP, MCP server

MailFlat

Official client libraries for MailFlat: email inboxes your code owns, with one-line OTP retrieval.

Compatibility: Not stated.

Grade B

Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

Rescanned at commit 63eed214e18a, unchanged since the check below.

NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ

Why this grade

  • NETWORK_NO_FIXED_HOST Low

    Makes a network call whose host is not written as a fixed address.

    packages/create-mailflat/src/templates.js, line 264 " await fetch(APP_URL + \"/api/signup\", {",

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    packages/create-mailflat/index.js, line 60 // 3) key - flag > MAILFLAT_API_KEY > prompt. Skipping is fine: .env gets a placeholder.

  • SECRETS_ENV_READ Note

    Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.

    packages/ai-sdk/src/tools.ts, line 142 * tools: { ...mailflatToolSuite({ apiKey: process.env.MAILFLAT_KEY }) },

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Pass

    No shell or command execution found, and no extra permission was declared.

  • Install and update

    Pass

    No install-time script found, and dependencies are pinned or absent.

  • Network

    Concern

    can reach a host that is not written as a fixed address.

    NETWORK_NO_FIXED_HOST

    packages/create-mailflat/src/templates.js, line 264

    " await fetch(APP_URL + \"/api/signup\", {",

    packages/create-mailflat/src/templates.js, line 347

    " requests.post(APP_URL + \"/api/signup\", json={\"email\": inbox.address}, timeout=30)",

    packages/js-sdk/src/client.ts, line 4

    // Uses global fetch (Node 18+ / modern browsers) - zero dependencies.

    Show more

    packages/js-sdk/src/payload.ts, line 14

    // the one the REST docs and every curl example use) was ignored, because only

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    packages/ai-sdk/src/tools.ts, line 142

    * tools: { ...mailflatToolSuite({ apiKey: process.env.MAILFLAT_KEY }) },

    packages/create-mailflat/index.js, line 60

    // 3) key - flag > MAILFLAT_API_KEY > prompt. Skipping is fine: .env gets a placeholder.

    packages/create-mailflat/index.js, line 63

    say(`\n Your API key goes in .env (gitignored). Get one at mailflat.net → Agents → API keys.`);

    Show more

    packages/create-mailflat/index.js, line 92

    if (!key) say(` # put your key in .env first`);

    packages/create-mailflat/scripts/build-examples.mjs, line 45

    "cp .env.example .env # paste your key",

    packages/create-mailflat/scripts/build-examples.mjs, line 146

    * ⚠️ A key is NEVER written: every example ships `.env.example` and no `.env` is produced.

    packages/create-mailflat/scripts/build-examples.mjs, line 147

    * (The scaffolder does write `.env`, because there the user is on their own machine; here the

    packages/create-mailflat/scripts/build-examples.mjs, line 166

    if (rel === ".env") continue; // no .env in a public repo; .env.example is enough

    packages/create-mailflat/scripts/build-examples.mjs, line 173

    write(".gitignore", ["node_modules/", ".env", ".venv/", "__pycache__/", ""].join("\n"));

    packages/create-mailflat/src/templates.js, line 123

    "const mf = new MailFlat({ apiKey: process.env.MAILFLAT_API_KEY! });",

    packages/create-mailflat/src/templates.js, line 218

    "export const mf = new MailFlat({ apiKey: process.env.MAILFLAT_API_KEY! });",

    packages/mcp/src/mailflat_mcp/server.py, line 82

    api_key=os.environ.get("MAILFLAT_API_KEY") or "",

    packages/python-sdk/src/mailflat/aio.py, line 333

    api_key = api_key or os.environ.get("MAILFLAT_API_KEY")

    packages/python-sdk/src/mailflat/client.py, line 54

    api_key = api_key or os.environ.get("MAILFLAT_API_KEY")

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Pass

    No encoded or minified payload found.

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit 63eed214e18a. can reach a host that is not written as a fixed address. reads a credential or environment file.

Date and source

Date checked:

View source

github.com

Commit graded: 63eed214e18aeab1c2f572be82dc2f6b787863d0

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen