Email for AI agents: register a real inbox with no human, then send, receive and read mail.
Connect Remote server
claude mcp add --transport http mailgi https://api.mailgi.xyz/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
{
"mcpServers": {
"mailgi": {
"url": "https://api.mailgi.xyz/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
{
"servers": {
"mailgi": {
"type": "http",
"url": "https://api.mailgi.xyz/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
Settings > Connectors > Add custom connector
URL: https://api.mailgi.xyz/mcp
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 67 found in our last check
register_agentCreates a new agent with its own email address and returns its API key, shown once.
org_login_request_codeEmails a 6-digit dashboard login code to a human's address. Creates the account on first login.
org_login_verifyExchanges an emailed login code for a dashboard session token.
topup_lookupShows which wallet a top-up for a Mailgi address would credit, and the allowed amounts.
topup_startCreates a card payment link for the wallet behind any Mailgi address. Give it to a human to pay.
topup_statusReturns whether a top-up payment has been paid and credited.
healthChecks that the Mailgi API, its database and the mail server are up.
agent_getReturns this agent's profile: its addresses, label and domain.
agent_usageReturns this agent's daily send and API counters; the latest day is partial.
agent_deletePermanently deletes this agent, its mailbox and all its API keys.
mail_listLists message headers in the mailbox, newest first by default; filter by folder with mailboxId.
mail_getReturns one message with its full text and HTML body.
mail_sendSends an email from this agent's address. Mail to outside addresses is charged to the wallet. Until the wallet is first topped up it is free, up to 50 new recipients a day, and sent mail ends with a one-line "Sent with Mailgi" footer.
mail_deleteMoves a message to the Trash folder.
mail_moveMoves a message to another folder.
mail_set_flagsMarks a message as seen or unseen, flagged or unflagged.
mailbox_listLists all folders, including Inbox, Sent and Trash.
mailbox_createCreates a folder, optionally nested under another.
mailbox_renameRenames a folder.
mailbox_deleteDeletes a custom folder.
apikey_listLists this agent's API keys. Key values are never shown again.
apikey_createCreates another API key for this agent. The key is shown once.
apikey_revokeRevokes an API key immediately.
billing_getReturns the wallet this agent spends from: balance, prices, the free tier and how to top up.
billing_topupCreates a card payment link for this agent's wallet. Give it to a human to pay.
billing_transactionsLists the wallet ledger, newest first.
webhook_listLists this agent's webhook endpoints.
webhook_createRegisters an HTTPS URL to be notified when mail arrives. The signing secret is shown once.
webhook_deleteDeletes a webhook endpoint.
webhook_deliveriesLists recent delivery attempts for a webhook endpoint.
webhook_resendQueues a delivery attempt to be sent again.
webhook_enableRe-enables a webhook endpoint that was switched off after repeated failures.
org_meReturns the signed-in user and the organizations they belong to.
org_logoutRevokes the current dashboard session token.
org_listLists the organizations the signed-in user belongs to.
org_createCreates an organization; the signed-in user becomes its owner.
org_getReturns one organization.
org_renameRenames an organization.
org_member_listLists an organization's members and their roles.
org_member_set_roleChanges a member's role.
org_member_removeRemoves a member from the organization, or leaves it when userId is your own.
org_invite_createEmails an invitation to join the organization.
org_invite_listLists pending invitations.
org_invite_revokeRevokes a pending invitation.
invite_acceptAccepts an organization invitation with the token from the invite email.
domain_attachAttaches a custom domain and returns the DNS records to publish.
domain_listLists an organization's custom domains.
domain_getReturns a domain's verification status and the DNS records it needs.
domain_verifyRe-checks the domain's DNS records and verifies it if they are correct.
domain_detachDetaches a custom domain from the organization.
domain_inbox_listLists the inboxes (agents) on a domain.
domain_inbox_createCreates an inbox with a chosen address on a domain. Its API key is shown once.
domain_inbox_deleteRemoves an inbox and its mail from a domain.
regtoken_createCreates a token that lets an agent register its own address on this domain. Shown once.
regtoken_listLists a domain's registration tokens.
regtoken_revokeRevokes a registration token.
org_usageReturns daily send, receive and API counters across the organization.
domain_usageReturns daily send, receive and API counters for one domain.
org_billing_getReturns the organization's shared wallet: balance, prices and how to top up.
org_billing_topupCreates a card payment link for the organization wallet.
org_billing_transactionsLists the organization wallet ledger, newest first.
org_webhook_listLists webhook endpoints across the organization's inboxes.
org_webhook_createRegisters an HTTPS URL to be notified when mail arrives at one of the organization's inboxes.
org_webhook_deleteDeletes a webhook endpoint.
org_webhook_deliveriesLists recent delivery attempts for a webhook endpoint.
org_webhook_resendQueues a delivery attempt to be sent again.
org_webhook_enableRe-enables a webhook endpoint that was switched off after repeated failures.
Headers
| Name | Description |
|---|---|
AuthorizationOptional, secret | Bearer <agent API key>. Optional: without it only public tools such as register_agent work. |
Details
| Endpoint | https://api.mailgi.xyz/mcp (Streamable HTTP) |
| First published | 1 Nov 2026 |
| Last updated | 1 Nov 2026 |
| Registry name | xyz.mailgi/mailgi |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
