Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "mailgi": {
      "type": "http",
      "url": "https://api.mailgi.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${MAILGI_TOKEN}"
      }
    }
  }
}

claude mcp add --transport http mailgi https://api.mailgi.xyz/mcp --header "Authorization: Bearer ${MAILGI_TOKEN}"

[mcp_servers.mailgi]
url = "https://api.mailgi.xyz/mcp"
bearer_token_env_var = "MAILGI_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mailgi": {
      "type": "remote",
      "url": "https://api.mailgi.xyz/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:MAILGI_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "mailgi": {
      "type": "http",
      "url": "https://api.mailgi.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${MAILGI_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=mailgi&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLm1haWxnaS54eXovbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7TUFJTEdJX1RPS0VOfSJ9fQ%3D%3D"
}

{
  "servers": {
    "mailgi": {
      "type": "http",
      "url": "https://api.mailgi.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${MAILGI_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "mailgi": {
      "httpUrl": "https://api.mailgi.xyz/mcp",
      "headers": {
        "Authorization": "Bearer ${MAILGI_TOKEN}"
      }
    }
  }
}

extensions:
  "mailgi":
    enabled: true
    name: "mailgi"
    type: streamable_http
    uri: "https://api.mailgi.xyz/mcp"
    headers:
      "Authorization": "Bearer ${MAILGI_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${MAILGI_TOKEN}. The registry never accepts secret values.

Quality 81 / 100new

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

warn
tools.descriptions1 of 67 tools have a description under 20 characters
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations67 of 67 tools declare readOnlyHint or destructiveHint
warn
tools.directory_hints7 of 67 tools declare all four hints; missing: mailbox_create (openWorldHint); webhook_delete (idempotentHint, openWorldHint); domain_list (destructiveHint, idempotentHint); …
pass
tools.token_costabout 6,707 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool history recorded for 6 of the 7 days needed

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

67 tools, about 6,707 tokens to load them all · tool set a5415f4652b1 · tools last changed 2026-11-04 · checked 2026-11-07 17:28 UTC

Tool changes

2026-11-04mail_sendchangeddescription
before
Sends 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 by mailgi.xyz" footer.
after · 95% of words in common
Sends 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.
2026-11-04billing_getchangeddescription
before
Returns the wallet this agent spends from: balance, prices and how to top up.
after · 88% of words in common
Returns the wallet this agent spends from: balance, prices, the free tier and how to top up.
2026-11-04mail_sendchangeddescriptionmeaning changed
before
Sends an email from this agent's address. Mail to outside addresses is charged to the wallet.
after · 43% of words in common
Sends 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 by mailgi.xyz" footer.

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 100 / 100

provenance100

liveness100

freshness100

hygiene100

+repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-100% +updated-6d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://api.mailgi.xyz/mcp` streamable-http	none	yes	100%	506 ms	2025-11-25	2026-11-07

Tools (67)

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

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "xyz.mailgi/mailgi",
  "title": "Mailgi",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://api.mailgi.xyz/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Bearer <agent API key>. Optional: without it only public tools such as register_agent work."
        }
      ]
    }
  ],
  "version": "1.0.0",
  "repository": {
    "url": "https://github.com/Mailgi/mailgi",
    "source": "github"
  },
  "websiteUrl": "https://www.mailgi.xyz/mcp.html",
  "description": "Email for AI agents: register a real inbox with no human, then send, receive and read mail."
}