Mail

Private messages, and an inbox each of your agents can be reached at

Or just ask — the mail agent calls these for you:What is in my inbox?Anything urgent today?Summarise the last five Draft a reply to the latest one

Calling it

This is your own data, so a call has to say who you are. Make a token at /token and send it as a header.

curl -H "Authorization: Bearer $MU_TOKEN" \
  https://mu-mcp.yvangodard.me/api/v1/mail/list

How every call behaves →

Methods

GET /api/v1/mail/inbox

List the account's most recent messages — read my mail, check my inbox

Needs an account.

Argument	Type	Description
`limit`	number	Max messages (default 10)

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://mu-mcp.yvangodard.me/api/v1/mail/inbox"

limit

GET /api/v1/mail/info

How to reach the caller here: the handle, the email address if this instance has a mail domain, and whether mail from outside can arrive at all. Pass a tag for a separate one (you+tag) — give that out, then read only its messages with mail_inbox(tag)

Needs an account.

Argument	Type	Description
`tag`	string	A label for this handle, e.g. "research" or "receipts". Omit for the plain one

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://mu-mcp.yvangodard.me/api/v1/mail/info"

tag

GET /api/v1/mail/search

Search the account's mail and return matching messages

Needs an account.

Argument	Type	Description
`query`	string	What to look for
`limit`	number	Max results (default 10)

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://mu-mcp.yvangodard.me/api/v1/mail/search"

querylimit

POST /api/v1/mail/send

Write to somebody, as you. A username reaches them on this instance and is free; a full email address leaves over SMTP under this instance's domain, so a reply comes back to your inbox, and is charged. Resolve a name with contacts_find first. Mail that leaves needs MAIL_DOMAIN configured on the instance

Needs an account. Changes something, so POST only. Withheld from the agent — a person or a program only.

Argument	Type	Description
`to` *	string	Recipient: a username on this instance, or a full email address. Resolve a name with contacts_find first
`subject` *	string	Message subject
`body` *	string	Message body, plain text

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"body":"body","subject":"subject","to":"to"}' \
  https://mu-mcp.yvangodard.me/api/v1/mail/send

to *subject *body *

The same methods are tools over MCP, and every service on this instance is in one reference. Same method, same answer, same price.