Messente MCP by usefulapi

Working · 636 ms

io.usefulapi/messentev1.6.0 Domain verified

Read Messente balance, prices, delivery status and statistics; send SMS to up to 10 numbers.

Communication

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://messente.usefulapi.io/mcp

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.

messente_add_to_blacklist

WRITE: add one phone number to the account's blacklist, so Messente will no longer send messages to it. Adding a number already listed is harmless. Messente: POST /phonebook/blacklist.

phone_numberstring, required

Phone number to blacklist, E.164 format, e.g. +37251000000.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (9)

messente_add_to_blacklist

WRITE: add one phone number to the account's blacklist, so Messente will no longer send messages to it. Adding a number already listed is harmless. Messente: POST /phonebook/blacklist.

Argument	Type	Description
phone_number*	string	Phone number to blacklist, E.164 format, e.g. +37251000000.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "phone_number"
  ],
  "properties": {
    "phone_number": {
      "type": "string",
      "pattern": "^\\+[1-9]\\d{6,14}$",
      "description": "Phone number to blacklist, E.164 format, e.g. +37251000000."
    }
  }
}

messente_check_blacklist

Check whether one phone number is on the account's blacklist. Messente: GET /phonebook/blacklist/{phone} (found = blacklisted, 404 = not).

read-only

Argument	Type	Description
phone*	string	Phone number in E.164 format, e.g. +37251000000.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "phone"
  ],
  "properties": {
    "phone": {
      "type": "string",
      "pattern": "^\\+[1-9]\\d{6,14}$",
      "description": "Phone number in E.164 format, e.g. +37251000000."
    }
  }
}

messente_get_balance

Get the Messente account's remaining SMS credit balance (in EUR). Messente legacy API: GET /get_balance (api2.messente.com).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

messente_get_delivery_status

Get the delivery report of a sent message by its omnimessage id (returned by messente_send_sms): per-message status (DELIVRD, UNDELIV, FAILED, ...), error and the price charged. Messente asks not to poll this for every message at scale. Messente: GET /omnimessage/{omnimessage_id}/status.

read-only

Argument	Type	Description
omnimessage_id*	string	The omnimessage_id returned when the message was sent.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "omnimessage_id"
  ],
  "properties": {
    "omnimessage_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The omnimessage_id returned when the message was sent."
    }
  }
}

messente_get_prices

Get this account's price per SMS part for one country, per mobile network (use it to estimate what messente_send_sms will cost). Messente legacy API: GET /prices.

read-only

Argument	Type	Description
country*	string	ISO 3166-1 alpha-2 country code, e.g. EE or GB.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code, e.g. EE or GB."
    }
  }
}

messente_get_statistics

Get total messages and total price per country for a date range, optionally for some message types. Messente: POST /statistics/reports (a read-only report).

read-only

Argument	Type	Description
end_date*	string	End date, YYYY-MM-DD.
start_date*	string	Start date, YYYY-MM-DD.
message_types	array	Limit the report to these message types.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "start_date",
    "end_date"
  ],
  "properties": {
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End date, YYYY-MM-DD."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date, YYYY-MM-DD."
    },
    "message_types": {
      "type": "array",
      "items": {
        "enum": [
          "sms",
          "viber",
          "whatsapp",
          "rcs",
          "hlr"
        ],
        "type": "string"
      },
      "maxItems": 5,
      "description": "Limit the report to these message types."
    }
  }
}

messente_list_blacklist

List the phone numbers on the account's blacklist (numbers Messente will not send to). Returns the total count and at most `limit` numbers. Messente: GET /phonebook/blacklist.

read-only

Argument	Type	Description
limit	integer	Maximum numbers to return (default 500).
offset	integer	Skip this many numbers (to page through a long list).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 2000,
      "minimum": 1,
      "description": "Maximum numbers to return (default 500)."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Skip this many numbers (to page through a long list)."
    }
  }
}

messente_lookup_numbers

Number lookup (HLR): is each number valid, ported, roaming, and which network it is on. COSTS CREDITS: Messente charges per number looked up (EUR 0.002 per number in its docs) and the Number Lookup service must be enabled on the account (a fixed monthly fee applies per Messente's docs). Up to 10 numbers per call. Messente: POST /hlr/sync.

Argument	Type	Description
numbers*	array	Phone numbers in E.164 format (1-10).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "numbers"
  ],
  "properties": {
    "numbers": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\+[1-9]\\d{6,14}$"
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "Phone numbers in E.164 format (1-10)."
    }
  }
}

messente_send_sms

WRITE: SENDS REAL SMS TEXT MESSAGES to real people and SPENDS the account's Messente credit (each recipient is charged per SMS part, longer texts use several parts; use messente_get_prices to estimate). SMS only, at most 10 recipients per call, one message per recipient, never to a list. Send only to people who asked to receive it (Messente forbids unsolicited messages). Not undoable. Messente: POST /omnimessage with channel sms, once per recipient.

destructive

Argument	Type	Description
to*	array	Recipient phone numbers in E.164 format (1-10).
text*	string	The message text.
sender	string	Sender name (alphanumeric, max 11 chars) or number; must be a sender verified on the account. Omit to use the account default.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "to",
    "text"
  ],
  "properties": {
    "to": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\+[1-9]\\d{6,14}$"
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "Recipient phone numbers in E.164 format (1-10)."
    },
    "text": {
      "type": "string",
      "maxLength": 1600,
      "minLength": 1,
      "description": "The message text."
    },
    "sender": {
      "type": "string",
      "pattern": "^[A-Za-z0-9 .+_-]+$",
      "maxLength": 20,
      "minLength": 1,
      "description": "Sender name (alphanumeric, max 11 chars) or number; must be a sender verified on the account. Omit to use the account default."
    }
  }
}