Email for AI agents: register a real inbox with no human, then send, receive and read mail.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <agent API key>. Optional: without it only public tools such as register_agent work.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Permanently deletes this agent, its mailbox and all its API keys.
This tool takes no arguments.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http mailgi https://api.mailgi.xyz/mcp
Headers
Authorization (optional, not in the config above): Bearer <agent API key>. Optional: without it only public tools such as register_agent work.Permanently deletes this agent, its mailbox and all its API keys.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Returns this agent's profile: its addresses, label and domain.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Returns this agent's daily send and API counters; the latest day is partial.
| Argument | Type | Description |
|---|---|---|
| to | any | ISO date, inclusive. Defaults to today. |
| from | string | ISO date, inclusive. Defaults to 30 days ago. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"$ref": "#/properties/from",
"description": "ISO date, inclusive. Defaults to today."
},
"from": {
"type": "string",
"description": "ISO date, inclusive. Defaults to 30 days ago."
}
},
"additionalProperties": false
}Creates another API key for this agent. The key is shown once.
| Argument | Type | Description |
|---|---|---|
| label | string | |
| expiresAt | string | ISO 8601 expiry date-time. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"label": {
"type": "string"
},
"expiresAt": {
"type": "string",
"description": "ISO 8601 expiry date-time."
}
},
"additionalProperties": false
}Lists this agent's API keys. Key values are never shown again.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Revokes an API key immediately.
| Argument | Type | Description |
|---|---|---|
| keyId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"keyId"
],
"properties": {
"keyId": {
"type": "string"
}
},
"additionalProperties": false
}Returns the wallet this agent spends from: balance, prices and how to top up.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Creates a card payment link for this agent's wallet. Give it to a human to pay.
| Argument | Type | Description |
|---|---|---|
| amountUsd* | number | USD; the minimum is in billing_get. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"amountUsd"
],
"properties": {
"amountUsd": {
"type": "number",
"maximum": 1000,
"minimum": 1,
"description": "USD; the minimum is in billing_get."
}
},
"additionalProperties": false
}Lists the wallet ledger, newest first.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}Attaches a custom domain and returns the DNS records to publish.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| domain* | string | e.g. example.com |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domain"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"domain": {
"type": "string",
"maxLength": 253,
"description": "e.g. example.com"
}
},
"additionalProperties": false
}Detaches a custom domain from the organization.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| domainId* | string | Domain ID from domain_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domainId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"domainId": {
"type": "string",
"description": "Domain ID from domain_list."
}
},
"additionalProperties": false
}Returns a domain's verification status and the DNS records it needs.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| domainId* | string | Domain ID from domain_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domainId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"domainId": {
"type": "string",
"description": "Domain ID from domain_list."
}
},
"additionalProperties": false
}Creates an inbox with a chosen address on a domain. Its API key is shown once.
| Argument | Type | Description |
|---|---|---|
| label | string | |
| orgId* | string | Organization ID from org_list. |
| domainId* | string | Domain ID from domain_list. |
| localPart* | string | e.g. "support" for [email protected] |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domainId",
"localPart"
],
"properties": {
"label": {
"type": "string",
"maxLength": 80
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"domainId": {
"type": "string",
"description": "Domain ID from domain_list."
},
"localPart": {
"type": "string",
"maxLength": 64,
"description": "e.g. \"support\" for [email protected]"
}
},
"additionalProperties": false
}Removes an inbox and its mail from a domain.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| agentId* | string | |
| domainId* | string | Domain ID from domain_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domainId",
"agentId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"agentId": {
"type": "string"
},
"domainId": {
"type": "string",
"description": "Domain ID from domain_list."
}
},
"additionalProperties": false
}Lists the inboxes (agents) on a domain.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| domainId* | string | Domain ID from domain_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domainId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"domainId": {
"type": "string",
"description": "Domain ID from domain_list."
}
},
"additionalProperties": false
}Lists an organization's custom domains.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Returns daily send, receive and API counters for one domain.
| Argument | Type | Description |
|---|---|---|
| to | string | ISO date, inclusive. Defaults to today. |
| from | string | ISO date, inclusive. Defaults to 30 days ago. |
| orgId* | string | Organization ID from org_list. |
| domainId* | string | Domain ID from domain_list. |
| breakdown | string | Split each day by agent. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domainId"
],
"properties": {
"to": {
"type": "string",
"description": "ISO date, inclusive. Defaults to today."
},
"from": {
"type": "string",
"description": "ISO date, inclusive. Defaults to 30 days ago."
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"domainId": {
"type": "string",
"description": "Domain ID from domain_list."
},
"breakdown": {
"enum": [
"agent"
],
"type": "string",
"description": "Split each day by agent."
}
},
"additionalProperties": false
}Re-checks the domain's DNS records and verifies it if they are correct.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| domainId* | string | Domain ID from domain_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domainId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"domainId": {
"type": "string",
"description": "Domain ID from domain_list."
}
},
"additionalProperties": false
}Checks that the Mailgi API, its database and the mail server are up.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Accepts an organization invitation with the token from the invite email.
| Argument | Type | Description |
|---|---|---|
| token* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"token"
],
"properties": {
"token": {
"type": "string"
}
},
"additionalProperties": false
}Moves a message to the Trash folder.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}Returns one message with its full text and HTML body.
| Argument | Type | Description |
|---|---|---|
| id* | string | Message ID from mail_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Message ID from mail_list."
}
},
"additionalProperties": false
}Lists message headers in the mailbox, newest first by default; filter by folder with mailboxId.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort by receivedAt. |
| limit | integer | Max messages to return. |
| position | integer | Zero-based offset for pagination. |
| mailboxId | string | Folder ID from mailbox_list. Omit for all mail. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"sort": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort by receivedAt."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max messages to return."
},
"position": {
"type": "integer",
"minimum": 0,
"description": "Zero-based offset for pagination."
},
"mailboxId": {
"type": "string",
"description": "Folder ID from mailbox_list. Omit for all mail."
}
},
"additionalProperties": false
}Moves a message to another folder.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| mailboxId* | string | Destination folder ID from mailbox_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"mailboxId"
],
"properties": {
"id": {
"type": "string"
},
"mailboxId": {
"type": "string",
"description": "Destination folder ID from mailbox_list."
}
},
"additionalProperties": false
}Sends an email from this agent's address. Mail to outside addresses is charged to the wallet.
| Argument | Type | Description |
|---|---|---|
| cc | array | |
| to* | array | Recipient addresses. |
| bcc | array | |
| replyTo | string | Reply-To address. |
| subject* | string | |
| htmlBody | string | HTML body. |
| textBody | string | Plain-text body. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"to",
"subject"
],
"properties": {
"cc": {
"type": "array",
"items": {
"type": "string",
"maxLength": 320
}
},
"to": {
"type": "array",
"items": {
"type": "string",
"maxLength": 320
},
"minItems": 1,
"description": "Recipient addresses."
},
"bcc": {
"type": "array",
"items": {
"type": "string",
"maxLength": 320
}
},
"replyTo": {
"type": "string",
"description": "Reply-To address."
},
"subject": {
"type": "string"
},
"htmlBody": {
"type": "string",
"description": "HTML body."
},
"textBody": {
"type": "string",
"description": "Plain-text body."
}
},
"additionalProperties": false
}Marks a message as seen or unseen, flagged or unflagged.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| seen | boolean | |
| flagged | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"seen": {
"type": "boolean"
},
"flagged": {
"type": "boolean"
}
},
"additionalProperties": false
}Creates a folder, optionally nested under another.
| Argument | Type | Description |
|---|---|---|
| name* | string | Folder name. |
| parentId | string | Parent folder ID for nesting. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Folder name."
},
"parentId": {
"type": "string",
"description": "Parent folder ID for nesting."
}
},
"additionalProperties": false
}Deletes a custom folder.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}Lists all folders, including Inbox, Sent and Trash.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Renames a folder.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| name* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}Returns the organization's shared wallet: balance, prices and how to top up.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Creates a card payment link for the organization wallet.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| amountUsd* | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"amountUsd"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"amountUsd": {
"type": "number",
"maximum": 1000,
"minimum": 1
}
},
"additionalProperties": false
}Lists the organization wallet ledger, newest first.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| orgId* | string | Organization ID from org_list. |
| offset | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"offset": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}Creates an organization; the signed-in user becomes its owner.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| slug | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 80
},
"slug": {
"type": "string",
"maxLength": 40
}
},
"additionalProperties": false
}Returns one organization.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Emails an invitation to join the organization.
| Argument | Type | Description |
|---|---|---|
| role | string | |
| email* | string | |
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"email"
],
"properties": {
"role": {
"enum": [
"admin",
"member"
],
"type": "string"
},
"email": {
"type": "string",
"format": "email"
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Lists pending invitations.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Revokes a pending invitation.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| inviteId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"inviteId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"inviteId": {
"type": "string"
}
},
"additionalProperties": false
}Lists the organizations the signed-in user belongs to.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Emails a 6-digit dashboard login code to a human's address. Creates the account on first login.
| Argument | Type | Description |
|---|---|---|
| email* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email"
}
},
"additionalProperties": false
}Exchanges an emailed login code for a dashboard session token.
| Argument | Type | Description |
|---|---|---|
| code* | string | |
| email* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email",
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 6,
"minLength": 6
},
"email": {
"type": "string",
"format": "email"
}
},
"additionalProperties": false
}Revokes the current dashboard session token.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Returns the signed-in user and the organizations they belong to.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Lists an organization's members and their roles.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Removes a member from the organization, or leaves it when userId is your own.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| userId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"userId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"userId": {
"type": "string"
}
},
"additionalProperties": false
}Changes a member's role.
| Argument | Type | Description |
|---|---|---|
| role* | string | |
| orgId* | string | Organization ID from org_list. |
| userId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"userId",
"role"
],
"properties": {
"role": {
"enum": [
"owner",
"admin",
"member"
],
"type": "string"
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"userId": {
"type": "string"
}
},
"additionalProperties": false
}Renames an organization.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 80
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Returns daily send, receive and API counters across the organization.
| Argument | Type | Description |
|---|---|---|
| to | string | ISO date, inclusive. Defaults to today. |
| from | string | ISO date, inclusive. Defaults to 30 days ago. |
| orgId* | string | Organization ID from org_list. |
| breakdown | string | Split each day by agent. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId"
],
"properties": {
"to": {
"type": "string",
"description": "ISO date, inclusive. Defaults to today."
},
"from": {
"type": "string",
"description": "ISO date, inclusive. Defaults to 30 days ago."
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"breakdown": {
"enum": [
"agent"
],
"type": "string",
"description": "Split each day by agent."
}
},
"additionalProperties": false
}Registers an HTTPS URL to be notified when mail arrives at one of the organization's inboxes.
| Argument | Type | Description |
|---|---|---|
| url* | string | HTTPS URL to POST notifications to. |
| orgId* | string | Organization ID from org_list. |
| agentId* | string | Inbox ID from domain_inbox_list. |
| eventTypes | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"agentId",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "HTTPS URL to POST notifications to."
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"agentId": {
"type": "string",
"description": "Inbox ID from domain_inbox_list."
},
"eventTypes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}Deletes a webhook endpoint.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"id"
],
"properties": {
"id": {
"type": "string"
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Lists recent delivery attempts for a webhook endpoint.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"id"
],
"properties": {
"id": {
"type": "string"
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Re-enables a webhook endpoint that was switched off after repeated failures.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"id"
],
"properties": {
"id": {
"type": "string"
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Lists webhook endpoints across the organization's inboxes.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
}
},
"additionalProperties": false
}Queues a delivery attempt to be sent again.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| orgId* | string | Organization ID from org_list. |
| deliveryId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"id",
"deliveryId"
],
"properties": {
"id": {
"type": "string"
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"deliveryId": {
"type": "string"
}
},
"additionalProperties": false
}Creates a new agent with its own email address and returns its API key, shown once.
| Argument | Type | Description |
|---|---|---|
| did | string | Optional did:key DID; only changes the alias address. |
| label | string | A name for your own reference. |
| localPart | string | Chosen address before the @, used with domainToken. |
| domainToken | string | Registration token for an organization's domain. Requires localPart. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"did": {
"type": "string",
"description": "Optional did:key DID; only changes the alias address."
},
"label": {
"type": "string",
"description": "A name for your own reference."
},
"localPart": {
"type": "string",
"description": "Chosen address before the @, used with domainToken."
},
"domainToken": {
"type": "string",
"description": "Registration token for an organization's domain. Requires localPart."
}
},
"additionalProperties": false
}Creates a token that lets an agent register its own address on this domain. Shown once.
| Argument | Type | Description |
|---|---|---|
| label | string | |
| orgId* | string | Organization ID from org_list. |
| domainId* | string | Domain ID from domain_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domainId"
],
"properties": {
"label": {
"type": "string",
"maxLength": 80
},
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"domainId": {
"type": "string",
"description": "Domain ID from domain_list."
}
},
"additionalProperties": false
}Lists a domain's registration tokens.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| domainId* | string | Domain ID from domain_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domainId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"domainId": {
"type": "string",
"description": "Domain ID from domain_list."
}
},
"additionalProperties": false
}Revokes a registration token.
| Argument | Type | Description |
|---|---|---|
| orgId* | string | Organization ID from org_list. |
| tokenId* | string | |
| domainId* | string | Domain ID from domain_list. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId",
"domainId",
"tokenId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Organization ID from org_list."
},
"tokenId": {
"type": "string"
},
"domainId": {
"type": "string",
"description": "Domain ID from domain_list."
}
},
"additionalProperties": false
}Shows which wallet a top-up for a Mailgi address would credit, and the allowed amounts.
| Argument | Type | Description |
|---|---|---|
| address* | string | The agent's email or alias address. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The agent's email or alias address."
}
},
"additionalProperties": false
}Creates a card payment link for the wallet behind any Mailgi address. Give it to a human to pay.
| Argument | Type | Description |
|---|---|---|
| address* | string | The agent's email or alias address. |
| amountUsd* | number | USD, within the range from topup_lookup. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address",
"amountUsd"
],
"properties": {
"address": {
"type": "string",
"description": "The agent's email or alias address."
},
"amountUsd": {
"type": "number",
"description": "USD, within the range from topup_lookup."
}
},
"additionalProperties": false
}Returns whether a top-up payment has been paid and credited.
| Argument | Type | Description |
|---|---|---|
| sessionId* | string | Checkout session ID from the payment link. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sessionId"
],
"properties": {
"sessionId": {
"type": "string",
"maxLength": 255,
"description": "Checkout session ID from the payment link."
}
},
"additionalProperties": false
}Registers an HTTPS URL to be notified when mail arrives. The signing secret is shown once.
| Argument | Type | Description |
|---|---|---|
| url* | string | HTTPS URL to POST notifications to. |
| eventTypes | array | Defaults to ["mail.received"]. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "HTTPS URL to POST notifications to."
},
"eventTypes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Defaults to [\"mail.received\"]."
}
},
"additionalProperties": false
}Deletes a webhook endpoint.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}Lists recent delivery attempts for a webhook endpoint.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}Re-enables a webhook endpoint that was switched off after repeated failures.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}Lists this agent's webhook endpoints.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Queues a delivery attempt to be sent again.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| deliveryId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"deliveryId"
],
"properties": {
"id": {
"type": "string"
},
"deliveryId": {
"type": "string"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 1, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.