What makes Mailgi — Free Email for Agents notable?

1.1K downloads. Trust evidence available

How should Mailgi — Free Email for Agents be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Mailgi — Free Email for Agents

Give an AI agent a real, deliverable email address. Register in one POST with no OAuth and no signup form, then send, receive, read and organise mail over a plain REST API — on a shared handle or your own verified domain. Skill: Mailgi — Free Email for Agents Owner: oyagev Summary: Give an AI agent a real, deliverable email address. Register in one POST with no OAuth and no signup form, then send, receive, read and organise mail over a plain REST API — on a shared handle or your own verified domain. Tags: latest:1.1.0 Version history: v1.1.0 | 2026-08-30T11:55:25.886Z | user Rewritten against the live API. Removes DID authentication a

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.1.0release · observed Aug 30, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s170q04698qp4kcr0jzqt3bejs851p1t:mailgi

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-oyagev-mailgi/snapshot"

Documentation

CLAWHUB

43,829 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: mailgi
description: Give an AI agent a real, deliverable email address. Register in one POST with no OAuth and no signup form, then send, receive, read and organise mail over a plain REST API — on a shared handle or your own verified domain.
version: 1.1.0
homepage: https://www.mailgi.xyz
metadata:
  openclaw:
    emoji: "📬"
    envVars:
      - name: MAILGI_API_KEY
        required: false
        description: An existing Mailgi API key. Not needed to get started — an agent registers with no credentials at all and stores the key it gets back.
---

# mailgi — SKILL FILE

This file teaches you how to use the mailgi email API.
You are an AI agent. Read this file, then you can send and receive email.

**Skill version 1.1.0 · updated 2026-08-30**
Canonical copy: https://www.mailgi.xyz/SKILL.md — if yours is older, re-fetch it.
This file tracks the live API; a stale copy will describe endpoints that changed.

**Base URL:** `https://api.mailgi.xyz`
**Auth:** `Authorization: Bearer <apiKey>` on all authenticated requests.

---

## 1. Get an email address

Register once. No password, no OAuth.

```
POST /v1/agents/register
Content-Type: application/json

{ "label": "my-agent" }
```

Optional fields:
- `label` — a name for your own reference; shows up in the owner's dashboard.
- `did` — a W3C DID in `did:key:` format. Only affects which deterministic
  alias you get. It does **not** enable password-free login (see section 7).

Response:
```json
{
  "agentId": "clxxx...",
  "emailAddress": "[email protected]",
  "aliasAddress": "[email protected]",
  "apiKey": "amb_...",
  "apiKeyId": "clyyy..."
}
```

**Store `apiKey` immediately. It is shown exactly once.**

`emailAddress` is your friendly address. Use it for sending and tell others to send to it.
`aliasAddress` is a deterministic alias — both receive mail to the same inbox.

---

## 2. Check your profile

```
GET /v1/agents/me
Authorization: Bearer <apiKey>
```

---

## 3. Read your inbox

```
GET /v1/mail
Authorization: Bearer <apiKey>
```

Optional query params:
- `mailboxId` — restrict to one folder
- `limit` — max results (default 20, max 100)
- `position` — pagination offset (default 0)
- `sort` — `asc` or `desc` (default `desc`)

**There is no search.** No full-text, subject, sender or date filtering exists —
any other query param is ignored, not rejected. To find a message, page through
the list and match it yourself.

Response: `{ messages: [...], total: N, position: N }`

Each message has: `id`, `subject`, `from`, `to`, `receivedAt`, `preview`, `seen`.

**There is no push delivery.** No webhooks, no WebSocket, no long-poll. The only
way to learn about new mail is to call `GET /v1/mail` again. Poll every few
seconds when waiting for something specific (a verification code), and every
minute or two for a background inbox.

**Get full body of a message:**

```
GET /v1/mail/<id>
Authorization: Bearer <apiKey>
```

Response includes `htmlBody` and/or `textBody`. If body is a

_meta.json

{
  "ownerId": "kn7esdxc68wsszmsqjx1ytzdm58501my",
  "slug": "mailgi",
  "version": "1.1.0",
  "publishedAt": 1788090925886
}

skill-card.md

## Description:

Give an AI agent a real, deliverable email address. Register in one POST with no OAuth and no signup form, then send, receive, read and organise mail over a plain REST API — on a shared handle or your own verified domain.

This skill is ready for commercial/non-commercial use.

## Publisher:

[oyagev](https://clawhub.ai/user/oyagev)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and agent operators use this skill to let an agent register a Mailgi mailbox, send and receive email, manage folders, and work with API keys through the Mailgi REST API, SDK, or CLI.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Mailgi API keys and custom-domain registration tokens can authorize mailbox actions if exposed.

Mitigation: Store them as secrets, avoid logging them, and revoke task-specific keys when they are no longer needed.

Risk: Email deletion and account deletion are destructive; deleting an account permanently burns the address.

Mitigation: Require explicit review before deleting messages, folders, API keys, or an agent account.

Risk: The optional CLI persists credentials locally.

Mitigation: Use the CLI only in environments where local credential storage is acceptable, and remove saved agents when access is no longer needed.

## Reference(s):

- [Mailgi homepage](https://www.mailgi.xyz)
- [Canonical Mailgi skill file](https://www.mailgi.xyz/SKILL.md)
- [Mailgi API documentation](https://api.mailgi.xyz/docs)
- [Mailgi OpenAPI specification](https://api.mailgi.xyz/openapi.json)
- [ClawHub skill page](https://clawhub.ai/oyagev/skills/mailgi)
- [ClawHub publisher profile](https://clawhub.ai/user/oyagev)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [Markdown guidance with REST examples, JSON payloads, shell commands, SDK snippets, and CLI commands]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Documents credential-bearing email workflows, mailbox management, API-key lifecycle operations, custom-domain registration, and operational limitations.]

## Skill Version(s):

1.1.0 (source: frontmatter and server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular