Contacts

The caller's own address book: turn a name into an address

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/contacts/list

How every call behaves →

Methods

POST /api/v1/contacts/add

Save someone to the address book. Adding a name already there updates it rather than making a second card

Needs an account. Changes something, so POST only.

Argument	Type	Description
`name` *	string	The person's name, e.g. "Sarah Chen"
`email`	string	Their email address
`phone`	string	Their phone number
`note`	string	Anything worth remembering about them

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"name"}' \
  https://mu-mcp.yvangodard.me/api/v1/contacts/add

name *emailphonenote

POST /api/v1/contacts/delete

Remove someone from the address book

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

Argument	Type	Description
`id` *	string	The contact's id, from contacts_find or contacts_list

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"id"}' \
  https://mu-mcp.yvangodard.me/api/v1/contacts/delete

id *

GET /api/v1/contacts/find

Look someone up in the address book by name, part of a name, or address. Use this before sending mail to a person named rather than addressed

Needs an account.

Argument	Type	Description
`query` *	string	A name, part of a name, or an address

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://mu-mcp.yvangodard.me/api/v1/contacts/find?query=query"

query *

GET /api/v1/contacts/list

List everyone in the caller's address book

Needs an account.

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

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