Servers Playground How we check Add a server Log in

Notifyre MCP by usefulapi

Working · 755 ms

io.usefulapi/notifyrev1.8.0 Domain verified

Read Notifyre SMS, replies, faxes, numbers, prices and contacts; 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://notifyre.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.

notifyre_add_contacts_to_groups

WRITE: adds existing contacts to existing groups (up to 100 contacts and 20 groups). Contacts keep their other groups. Adding a contact to a group does not send anything, but a later send to that group reaches it. Notifyre API: POST /addressbook/groups/contacts.

group_idsarray, required

Group ids.

contact_idsarray, required

Contact ids.

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

Notifyre MCP by usefulapi MCP server | mcptry

Tools (21)

notifyre_add_contacts_to_groups

Argument	Type	Description
group_ids*	array	Group ids.
contact_ids*	array	Contact ids.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contact_ids",
    "group_ids"
  ],
  "properties": {
    "group_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "Group ids."
    },
    "contact_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Contact ids."
    }
  }
}

notifyre_create_contact

WRITE: adds one contact to the Notifyre address book. Give at least a name or a number. Numbers in international format (e.g. +61412345678). groups takes existing group ids; group_name puts the contact in that group and CREATES the group if it does not exist. Creating the same contact twice may make a duplicate. Notifyre API: POST /addressbook/contacts.

Argument	Type	Description
email	string	Email address.
group_ids	array	Existing group ids to add the contact to.
last_name	string	Family name.
fax_number	string	Fax number, international format.
first_name	string	Given name.
group_name	string	Group name to add the contact to (created if missing).
organization	string	Organization or company.
mobile_number	string	Mobile number, international format.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "email": {
      "type": "string",
      "maxLength": 254,
      "description": "Email address."
    },
    "group_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "maxItems": 20,
      "description": "Existing group ids to add the contact to."
    },
    "last_name": {
      "type": "string",
      "maxLength": 100,
      "description": "Family name."
    },
    "fax_number": {
      "type": "string",
      "maxLength": 30,
      "description": "Fax number, international format."
    },
    "first_name": {
      "type": "string",
      "maxLength": 100,
      "description": "Given name."
    },
    "group_name": {
      "type": "string",
      "maxLength": 100,
      "description": "Group name to add the contact to (created if missing)."
    },
    "organization": {
      "type": "string",
      "maxLength": 200,
      "description": "Organization or company."
    },
    "mobile_number": {
      "type": "string",
      "maxLength": 30,
      "description": "Mobile number, international format."
    }
  }
}

notifyre_create_group

WRITE: creates one address book group with the given name. Notifyre API: POST /addressbook/groups.

Argument	Type	Description
name*	string	The group name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The group name."
    }
  }
}

notifyre_get_contact

Get one contact: names, organization, email, fax and mobile number, groups, custom fields, unsubscribed flag. Notifyre API: GET /addressbook/contacts/{id}.

read-only

Argument	Type	Description
contact_id*	string	The contact id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contact_id"
  ],
  "properties": {
    "contact_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The contact id."
    }
  }
}

notifyre_get_sent_sms

Get one sent SMS message with every recipient: status, delivery status, message parts, cost. Use the id from notifyre_list_sent_sms or notifyre_send_sms. Notifyre API: GET /sms/send/{id}.

read-only

Argument	Type	Description
message_id*	string	The SMS message id (not the friendly id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "message_id"
  ],
  "properties": {
    "message_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The SMS message id (not the friendly id)."
    }
  }
}

notifyre_get_sms_recipient

Get the text and delivery details of one recipient of a sent SMS (status, parts, cost). Notifyre API: GET /sms/send/{messageId}/recipients/{recipientId}.

read-only

Argument	Type	Description
message_id*	string	The SMS message id.
recipient_id*	string	The recipient id from get_sent_sms.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "message_id",
    "recipient_id"
  ],
  "properties": {
    "message_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The SMS message id."
    },
    "recipient_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The recipient id from get_sent_sms."
    }
  }
}

notifyre_get_sms_reply

Get one received SMS reply with its text, sender and receiving number. Use the replyID from notifyre_list_sms_replies. Notifyre API: GET /sms/received/{id}.

read-only

Argument	Type	Description
reply_id*	string	The reply id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "reply_id"
  ],
  "properties": {
    "reply_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The reply id."
    }
  }
}

notifyre_list_brands

List the account's registered 10DLC brands (US SMS sender registration). Notifyre API: GET /numbers/brands.

read-only

No arguments.

Input schema (JSON)

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

notifyre_list_campaigns

List the account's 10DLC campaigns (US SMS use-case registrations) and their status. Notifyre API: GET /numbers/campaigns.

read-only

No arguments.

Input schema (JSON)

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

notifyre_list_contacts

Search the address book. search_query matches the name; type FaxNumber or MobileNumber keeps contacts that have that number; group_ids limits to groups. Page numbers start at 0. Contacts that unsubscribed are left out unless include_unsubscribed is true. The unsubscribe key of a contact is never shown. Notifyre API: POST /addressbook/contacts/search (a read).

read-only

Argument	Type	Description
page	integer	Page number, from 0 (default 0).
type	string	Only contacts that have this kind of number.
limit	integer	Page size, 1 to 100 (default 20).
sort_by	string	Sort field (default name).
sort_dir	string	asc or desc (default asc).
group_ids	array	Only contacts in these group ids.
search_query	string	Text in the contact's name.
include_unsubscribed	boolean	Also return contacts that unsubscribed (default false).

Input schema (JSON)

notifyre_list_fax_cover_pages

List the fax cover page templates of the account (name and whether it is the default). The HTML of each template is left out. Notifyre API: GET /fax/coverpages.

read-only

No arguments.

Input schema (JSON)

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

notifyre_list_fax_numbers

List the account's fax numbers (E.164, region, status). Notifyre API: GET /fax/numbers.

read-only

No arguments.

Input schema (JSON)

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

notifyre_list_fax_prices

List the price of sending a fax per destination country (country code, calling prefix, price, currency). Notifyre API: GET /fax/send/prices.

read-only

No arguments.

Input schema (JSON)

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

notifyre_list_groups

List the address book groups with their contact counts. Notifyre API: GET /addressbook/groups.

read-only

Argument	Type	Description
sort_by	string	Sort field (default name).
sort_dir	string	asc or desc (default asc).
search_query	string	Text in the group name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "sort_by": {
      "enum": [
        "name",
        "date_created"
      ],
      "type": "string",
      "description": "Sort field (default name)."
    },
    "sort_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "asc or desc (default asc)."
    },
    "search_query": {
      "type": "string",
      "maxLength": 200,
      "description": "Text in the group name."
    }
  }
}

notifyre_list_received_faxes

List faxes received on the account's fax numbers (sender, number, time, pages, duration, read flag). The fax documents are not downloaded. Without from_date the window is the last 30 days. Page with skip = next_skip. Notifyre API: GET /fax/received.

read-only

Argument	Type	Description
skip	integer	Records to skip (default 0).
sort	string	asc or desc by date (default desc).
limit	integer	Page size, 1 to 100 (default 20).
to_date	string	End, ISO 8601 date or date-time. Default: now.
from_date	string	Start, ISO 8601 date or date-time with timezone. Default: 30 days before to_date.
to_number	string	Only faxes received on this account fax number.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "skip": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Records to skip (default 0)."
    },
    "sort": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "asc or desc by date (default desc)."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1 to 100 (default 20)."
    },
    "to_date": {
      "type": "string",
      "description": "End, ISO 8601 date or date-time. Default: now."
    },
    "from_date": {
      "type": "string",
      "description": "Start, ISO 8601 date or date-time with timezone. Default: 30 days before to_date."
    },
    "to_number": {
      "type": "string",
      "maxLength": 30,
      "description": "Only faxes received on this account fax number."
    }
  }
}

notifyre_list_sent_faxes

List faxes sent from the account (recipient, pages, quality, status, failure reason). Without from_date the window is the last 30 days. Filter by status (accepted, successful, in_progress, failed, queued). Page with skip = next_skip. Notifyre API: GET /fax/send.

read-only

Argument	Type	Description
skip	integer	Records to skip (default 0).
sort	string	asc or desc by date (default desc).
limit	integer	Page size, 1 to 100 (default 20).
search	string	Filter by fax id or reference.
status	string	Only faxes with this status.
to_date	string	End, ISO 8601 date or date-time. Default: now.
from_date	string	Start, ISO 8601 date or date-time with timezone. Default: 30 days before to_date.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "skip": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Records to skip (default 0)."
    },
    "sort": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "asc or desc by date (default desc)."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1 to 100 (default 20)."
    },
    "search": {
      "type": "string",
      "maxLength": 100,
      "description": "Filter by fax id or reference."
    },
    "status": {
      "enum": [
        "accepted",
        "successful",
        "in_progress",
        "failed",
        "queued"
      ],
      "type": "string",
      "description": "Only faxes with this status."
    },
    "to_date": {
      "type": "string",
      "description": "End, ISO 8601 date or date-time. Default: now."
    },
    "from_date": {
      "type": "string",
      "description": "Start, ISO 8601 date or date-time with timezone. Default: 30 days before to_date."
    }
  }
}

notifyre_list_sent_sms

List SMS messages sent from the account, newest first by default, with recipient, status and cost. Without from_date the window is the last 30 days. Filter by status (processing, submitted, sent, failed), numbers, or a message id in search. Page with skip = next_skip. Notifyre API: GET /sms/send.

read-only

Argument	Type	Description
skip	integer	Records to skip (default 0).
sort	string	asc or desc by date (default desc).
limit	integer	Page size, 1 to 100 (default 20).
search	string	Filter by message id or scheduled job id.
status	string	Only messages with this status.
to_date	string	End, ISO 8601 date (2026-10-31, to the end of that UTC day) or date-time. Default: now.
from_date	string	Start, ISO 8601 date (2026-10-01) or date-time with timezone. Default: 30 days before to_date.
to_number	string	Destination number the SMS was sent to.

notifyre_list_sms_numbers

List the account's SMS numbers (E.164, status, 10DLC campaign) and approved alphanumeric sender IDs. Use one of them as `from` when sending. Notifyre API: GET /sms/numbers.

read-only

No arguments.

Input schema (JSON)

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

notifyre_list_sms_prices

List the price of one SMS per destination country (country code, calling prefix, price, currency). Check it before sending: the cost of a send is price x message parts x recipients. Notifyre API: GET /sms/send/prices.

read-only

No arguments.

Input schema (JSON)

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

notifyre_list_sms_replies

List SMS replies received on the account's numbers. Without from_date the window is the last 30 days. from_number and to_number must be given together. include_reply_content adds the reply texts (then at most 20 per page). Page with skip = next_skip. Notifyre API: GET /sms/received.

read-only

Argument	Type	Description
skip	integer	Records to skip (default 0).
sort	string	asc or desc by date (default desc).
limit	integer	Page size, 1 to 100 (default 20).
to_date	string	End, ISO 8601 date or date-time. Default: now.
from_date	string	Start, ISO 8601 date or date-time with timezone. Default: 30 days before to_date.
to_number	string	Account number that received the reply. Needs from_number as well.
from_number	string	Number the reply came from. Needs to_number as well.
recipient_id	string	Only replies to this SMS recipient id.

notifyre_send_sms

WRITE: SENDS REAL SMS to real people and SPENDS the prepaid balance of the user's Notifyre account; it cannot be undone or recalled and is never retried. One text to 1 to 10 mobile numbers in international format with "+" (e.g. +61412345678); no contacts, no groups, no scheduling. Cost = price per message part (see notifyre_list_sms_prices; it depends on the destination country) x number of parts x number of recipients; the text may be up to 640 characters (160 per part, 70 with emoji or non-GSM characters, a little less per part when it is longer). Only send what the user explicitly asked for: confirm the exact text, the recipients and the sender first. Recipients must have agreed to receive messages. A commercial SMS needs an opt-out (Australia: Spam Act 2003; Notifyre Terms and Conditions 13.5): set add_unsubscribe_link true to append Notifyre's opt-out link, or put your own opt-out instruction in the text. The default is false, so the requirement is yours to meet. US numbers need a registered 10DLC campaign. Omit `from` to send from a Notifyre shared number. An unclear result (timeout, HTTP 5xx) means the message may still have been sent: check notifyre_list_sent_sms before trying again. Notifyre API: POST /sms/send.

destructive

Argument	Type	Description
to*	array	1 to 10 mobile numbers in international format with country code and "+", e.g. +61412345678.
body*	string	The message text.
from	string	Optional sender: one of the account's SMS numbers or sender IDs (see notifyre_list_sms_numbers). Omit to use a Notifyre shared number.
campaign_name	string

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page number, from 0 (default 0)."
    },
    "type": {
      "enum": [
        "FaxNumber",
        "MobileNumber"
      ],
      "type": "string",
      "description": "Only contacts that have this kind of number."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, 1 to 100 (default 20)."
    },
    "sort_by": {
      "type": "string",
      "maxLength": 40,
      "description": "Sort field (default name)."
    },
    "sort_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "asc or desc (default asc)."
    },
    "group_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "maxItems": 50,
      "description": "Only contacts in these group ids."
    },
    "search_query": {
      "type": "string",
      "maxLength": 200,
      "description": "Text in the contact's name."
    },
    "include_unsubscribed": {
      "type": "boolean",
      "description": "Also return contacts that unsubscribed (default false)."
    }
  }
}