Mailgi

xyz.mailgi/mailgi · v1.0.0 · agents-and-memory

Mailgi is healthy: it completed an MCP handshake in 2292 ms and exposes 67 tools.

Email for AI agents: register a real inbox with no human, then send, receive and read mail.

Endpoint: https://api.mailgi.xyz/mcp (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)	0
Handshake	Healthy
Auth needed	None
Tool count	67
Latency	2292 ms
Last checked (UTC)	2026-11-01T19:50:28.939Z

Health history

Checked (UTC)	Status	Latency	Error
2026-11-01T19:50:28.939Z	Healthy	2292

Tools (67)

`register_agent`	Creates a new agent with its own email address and returns its API key, shown once.
`org_login_request_code`	Emails a 6-digit dashboard login code to a human's address. Creates the account on first login.
`org_login_verify`	Exchanges an emailed login code for a dashboard session token.
`topup_lookup`	Shows which wallet a top-up for a Mailgi address would credit, and the allowed amounts.
`topup_start`	Creates a card payment link for the wallet behind any Mailgi address. Give it to a human to pay.
`topup_status`	Returns whether a top-up payment has been paid and credited.
`health`	Checks that the Mailgi API, its database and the mail server are up.
`agent_get`	Returns this agent's profile: its addresses, label and domain.
`agent_usage`	Returns this agent's daily send and API counters; the latest day is partial.
`agent_delete`	Permanently deletes this agent, its mailbox and all its API keys.
`mail_list`	Lists message headers in the mailbox, newest first by default; filter by folder with mailboxId.
`mail_get`	Returns one message with its full text and HTML body.
`mail_send`	Sends an email from this agent's address. Mail to outside addresses is charged to the wallet.
`mail_delete`	Moves a message to the Trash folder.
`mail_move`	Moves a message to another folder.
`mail_set_flags`	Marks a message as seen or unseen, flagged or unflagged.
`mailbox_list`	Lists all folders, including Inbox, Sent and Trash.
`mailbox_create`	Creates a folder, optionally nested under another.
`mailbox_rename`	Renames a folder.
`mailbox_delete`	Deletes a custom folder.
`apikey_list`	Lists this agent's API keys. Key values are never shown again.
`apikey_create`	Creates another API key for this agent. The key is shown once.
`apikey_revoke`	Revokes an API key immediately.
`billing_get`	Returns the wallet this agent spends from: balance, prices and how to top up.
`billing_topup`	Creates a card payment link for this agent's wallet. Give it to a human to pay.
`billing_transactions`	Lists the wallet ledger, newest first.
`webhook_list`	Lists this agent's webhook endpoints.
`webhook_create`	Registers an HTTPS URL to be notified when mail arrives. The signing secret is shown once.
`webhook_delete`	Deletes a webhook endpoint.
`webhook_deliveries`	Lists recent delivery attempts for a webhook endpoint.
`webhook_resend`	Queues a delivery attempt to be sent again.
`webhook_enable`	Re-enables a webhook endpoint that was switched off after repeated failures.
`org_me`	Returns the signed-in user and the organizations they belong to.
`org_logout`	Revokes the current dashboard session token.
`org_list`	Lists the organizations the signed-in user belongs to.
`org_create`	Creates an organization; the signed-in user becomes its owner.
`org_get`	Returns one organization.
`org_rename`	Renames an organization.
`org_member_list`	Lists an organization's members and their roles.
`org_member_set_role`	Changes a member's role.
`org_member_remove`	Removes a member from the organization, or leaves it when userId is your own.
`org_invite_create`	Emails an invitation to join the organization.
`org_invite_list`	Lists pending invitations.
`org_invite_revoke`	Revokes a pending invitation.
`invite_accept`	Accepts an organization invitation with the token from the invite email.
`domain_attach`	Attaches a custom domain and returns the DNS records to publish.
`domain_list`	Lists an organization's custom domains.
`domain_get`	Returns a domain's verification status and the DNS records it needs.
`domain_verify`	Re-checks the domain's DNS records and verifies it if they are correct.
`domain_detach`	Detaches a custom domain from the organization.
`domain_inbox_list`	Lists the inboxes (agents) on a domain.
`domain_inbox_create`	Creates an inbox with a chosen address on a domain. Its API key is shown once.
`domain_inbox_delete`	Removes an inbox and its mail from a domain.
`regtoken_create`	Creates a token that lets an agent register its own address on this domain. Shown once.
`regtoken_list`	Lists a domain's registration tokens.
`regtoken_revoke`	Revokes a registration token.
`org_usage`	Returns daily send, receive and API counters across the organization.
`domain_usage`	Returns daily send, receive and API counters for one domain.
`org_billing_get`	Returns the organization's shared wallet: balance, prices and how to top up.
`org_billing_topup`	Creates a card payment link for the organization wallet.
`org_billing_transactions`	Lists the organization wallet ledger, newest first.
`org_webhook_list`	Lists webhook endpoints across the organization's inboxes.
`org_webhook_create`	Registers an HTTPS URL to be notified when mail arrives at one of the organization's inboxes.
`org_webhook_delete`	Deletes a webhook endpoint.
`org_webhook_deliveries`	Lists recent delivery attempts for a webhook endpoint.
`org_webhook_resend`	Queues a delivery attempt to be sent again.
`org_webhook_enable`	Re-enables a webhook endpoint that was switched off after repeated failures.