# MailGenius — Pipedream Connect

> Free Email SpamChecker. Use our Mail Tester to run a Email Deliverability Test and check email spam score.

- API slug: `mailgenius` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Communication
- Website: https://www.mailgenius.com/
- This page (HTML): https://pipedream.com/apps/mailgenius
- Tools: 4 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: mailgenius`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "mailgenius",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Get Daily Limit:
const result = await mcp.callTool({
  name: "mailgenius-get-daily-limit",
  arguments: {},
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a MailGenius endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://app.mailgenius.com/external/api/audits

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcHAubWFpbGdlbml1cy5jb20vZXh0ZXJuYWwvYXBpL2F1ZGl0cw?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "mailgenius-get-daily-limit",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mailgenius: { authProvisionId: "apn_xxxxxxx" },
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (4)

### `mailgenius-get-daily-limit` — Get Daily Limit (Write)

Returns daily limit for api token, how many email tests are used in last 24 hours and how many are still remaining for use. See the documentation

Full schema: https://pipedream.com/apps/mailgenius/actions/get-daily-limit.md

### `mailgenius-get-email-audit` — Get Email Audit (Write)

Returns generated test email, limit exceeded if daily limit is reached. See the documentation

Full schema: https://pipedream.com/apps/mailgenius/actions/get-email-audit.md

### `mailgenius-get-email-result` — Get Email Results (Write)

Returns the results of the test. See the documentation

Full schema: https://pipedream.com/apps/mailgenius/actions/get-email-result.md

### `mailgenius-list-slug-options` — List Model Options (Read-only)

Retrieves available options for the Model field.

Full schema: https://pipedream.com/apps/mailgenius/actions/list-slug-options.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt