SMS

Text somebody, and read what they text back

Open SMS →

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

How every call behaves →

Methods

GET /api/v1/sms/history

Read the texts this account has sent and received, newest first. Both directions, which is why it is not called an inbox

Needs an account.

ArgumentTypeDescription
limitnumberHow many messages to return, newest first (default 50, max 200)
curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://mu-mcp.yvangodard.me/api/v1/sms/history"
GET /api/v1/sms/number

The number texts are sent from, which numbers are verified as yours, and how many messages are left today

Needs an account.

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://mu-mcp.yvangodard.me/api/v1/sms/number"
POST /api/v1/sms/send

Text somebody, from this instance's number. Charged per 160-character segment, capped per day, and the recipient can stop it with STOP

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

ArgumentTypeDescription
to *stringThe number to text, in international format, e.g. +447700900123. Use contacts_find to turn a name into one
text *stringWhat to say. Charged per 160-character segment, so brevity is not only good manners
curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"text","to":"to"}' \
  https://mu-mcp.yvangodard.me/api/v1/sms/send
POST /api/v1/sms/verify

Claim a number as your own, so texts arriving from it reach this account. Call it with just the number to have a code texted there, then again with the code

Needs an account. Changes something, so POST only.

ArgumentTypeDescription
number *stringYour own number, in international format
codestringThe code that was texted to that number. Omit to have one sent
curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"number":"number"}' \
  https://mu-mcp.yvangodard.me/api/v1/sms/verify

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