FireText MCP by usefulapi is an MCP server published by io.usefulapi, hosted at firetext.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 13 tools, including firetext_get_credit, firetext_list_received_messages, firetext_list_sent_messages, firetext_get_sent_summary, firetext_list_scheduled_messages.
Read FireText credit, messages and reports; send an SMS to up to 10 numbers; manage opt-outs.
4,037 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Number of SMS credits (messages) remaining on the FireText account or a sub-account. FireText: /credit.
| Parameter | Type | Description |
|---|---|---|
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_get_credit",
"title": "Get SMS credit",
"description": "Number of SMS credits (messages) remaining on the FireText account or a sub-account. FireText: /credit.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "Get SMS credit",
"readOnlyHint": true
}
}Inbound SMS received on the account's FireText numbers/keywords (messageID, sentTo, keyword, receivedFrom, receivedOn, message). Dates YYYY-MM-DD; from="last" returns only what is new since the last call. FireText: /receivedmessages.
| Parameter | Type | Description |
|---|---|---|
| pp | any | Results per page: 10, 25 (default), 50 or 100. |
| to | string | End date YYYY-MM-DD. |
| from | string | Start date YYYY-MM-DD, or "last" for only what is new since the last access. |
| page | integer | Page number (1-based). |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_list_received_messages",
"title": "List received messages",
"description": "Inbound SMS received on the account's FireText numbers/keywords (messageID, sentTo, keyword, receivedFrom, receivedOn, message). Dates YYYY-MM-DD; from=\"last\" returns only what is new since the last call. FireText: /receivedmessages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pp": {
"anyOf": [
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 25
},
{
"type": "number",
"const": 50
},
{
"type": "number",
"const": 100
}
],
"description": "Results per page: 10, 25 (default), 50 or 100."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^(\\d{4}-\\d{2}-\\d{2}|last)$",
"description": "Start date YYYY-MM-DD, or \"last\" for only what is new since the last access."
},
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number (1-based)."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "List received messages",
"readOnlyHint": true
}
}Messages (campaigns) sent from the account: messageID, sentOn, sentTo (group), recipientCount, message. The messageID is what the delivery and click reports need. Dates YYYY-MM-DD. FireText: /sentmessages.
| Parameter | Type | Description |
|---|---|---|
| pp | any | Results per page: 10, 25 (default), 50 or 100. |
| to | string | End date YYYY-MM-DD. |
| from | string | Start date YYYY-MM-DD, or "last" for only what is new since the last access. |
| page | integer | Page number (1-based). |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_list_sent_messages",
"title": "List sent messages",
"description": "Messages (campaigns) sent from the account: messageID, sentOn, sentTo (group), recipientCount, message. The messageID is what the delivery and click reports need. Dates YYYY-MM-DD. FireText: /sentmessages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pp": {
"anyOf": [
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 25
},
{
"type": "number",
"const": 50
},
{
"type": "number",
"const": 100
}
],
"description": "Results per page: 10, 25 (default), 50 or 100."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^(\\d{4}-\\d{2}-\\d{2}|last)$",
"description": "Start date YYYY-MM-DD, or \"last\" for only what is new since the last access."
},
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number (1-based)."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "List sent messages",
"readOnlyHint": true
}
}Totals for a date range: number of campaigns, recipients and credits used. FireText: /sentreport.
| Parameter | Type | Description |
|---|---|---|
| to * | string | End date YYYY-MM-DD. |
| from * | string | Start date YYYY-MM-DD. |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_get_sent_summary",
"title": "Get sent summary",
"description": "Totals for a date range: number of campaigns, recipients and credits used. FireText: /sentreport.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date YYYY-MM-DD."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "Get sent summary",
"readOnlyHint": true
}
}Messages queued for later sending (messageID, queuedOn, scheduledFor, recipientCount, sourceAddress, sendTo, message). FireText: /scheduledmessages.
| Parameter | Type | Description |
|---|---|---|
| pp | any | Results per page: 10, 25 (default), 50 or 100. |
| page | integer | Page number (1-based). |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_list_scheduled_messages",
"title": "List scheduled messages",
"description": "Messages queued for later sending (messageID, queuedOn, scheduledFor, recipientCount, sourceAddress, sendTo, message). FireText: /scheduledmessages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pp": {
"anyOf": [
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 25
},
{
"type": "number",
"const": 50
},
{
"type": "number",
"const": 100
}
],
"description": "Results per page: 10, 25 (default), 50 or 100."
},
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number (1-based)."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "List scheduled messages",
"readOnlyHint": true
}
}Per-recipient delivery status of one sent message (mobile, names, messageSent, messageUpdate, status: Delivered / Declined / Buffered / Pending with Network / Rejected / Unconfirmed). Give the FireText message id OR the custom reference used when sending. FireText: /deliveryreport.
| Parameter | Type | Description |
|---|---|---|
| pp | any | Results per page: 10000 or 25000 (the vendor's only choices for this report). Large; omit for the vendor default. |
| page | integer | Page number (1-based). |
| message | string | FireText message ID (see firetext_list_sent_messages). |
| reference | string | The custom reference set when sending (alternative to message). |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_get_delivery_report",
"title": "Get delivery report",
"description": "Per-recipient delivery status of one sent message (mobile, names, messageSent, messageUpdate, status: Delivered / Declined / Buffered / Pending with Network / Rejected / Unconfirmed). Give the FireText message id OR the custom reference used when sending. FireText: /deliveryreport.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pp": {
"anyOf": [
{
"type": "number",
"const": 10000
},
{
"type": "number",
"const": 25000
}
],
"description": "Results per page: 10000 or 25000 (the vendor's only choices for this report). Large; omit for the vendor default."
},
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number (1-based)."
},
"message": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,40}$",
"description": "FireText message ID (see firetext_list_sent_messages)."
},
"reference": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The custom reference set when sending (alternative to message)."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "Get delivery report",
"readOnlyHint": true
}
}Link clicks for one sent message (mobile, names, clicked, userAgent). Only for messages that used FireText's Trackable SMS feature (otherwise the vendor answers URL error). FireText: /clickreport.
| Parameter | Type | Description |
|---|---|---|
| pp | any | Results per page: 10000 or 25000 (the vendor's only choices for this report). Large; omit for the vendor default. |
| page | integer | Page number (1-based). |
| message * | string | FireText message ID (see firetext_list_sent_messages). |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_get_click_report",
"title": "Get click report",
"description": "Link clicks for one sent message (mobile, names, clicked, userAgent). Only for messages that used FireText's Trackable SMS feature (otherwise the vendor answers URL error). FireText: /clickreport.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message"
],
"properties": {
"pp": {
"anyOf": [
{
"type": "number",
"const": 10000
},
{
"type": "number",
"const": 25000
}
],
"description": "Results per page: 10000 or 25000 (the vendor's only choices for this report). Large; omit for the vendor default."
},
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number (1-based)."
},
"message": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,40}$",
"description": "FireText message ID (see firetext_list_sent_messages)."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "Get click report",
"readOnlyHint": true
}
}Stored details of one contact by mobile number (firstname, lastname, mobile, customField1-3). FireText: /contactinfo.
| Parameter | Type | Description |
|---|---|---|
| mobile * | string | Mobile number: UK 07700900123 / 447700900123, or international without + and leading zeros (e.g. 33612345678). |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_get_contact",
"title": "Get contact",
"description": "Stored details of one contact by mobile number (firstname, lastname, mobile, customField1-3). FireText: /contactinfo.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mobile"
],
"properties": {
"mobile": {
"type": "string",
"maxLength": 32,
"minLength": 1,
"description": "Mobile number: UK 07700900123 / 447700900123, or international without + and leading zeros (e.g. 33612345678)."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "Get contact",
"readOnlyHint": true
}
}Contacts that opted out (names, mobile, custom fields, addedOn, unsubscribedOn, reason). Optional date range and group API id. FireText: /unsubscribed.
| Parameter | Type | Description |
|---|---|---|
| pp | any | Results per page: 10, 25 (default), 50 or 100. |
| to | string | End date YYYY-MM-DD. |
| from | string | Start date YYYY-MM-DD, or "last" for only what is new since the last access. |
| page | integer | Page number (1-based). |
| group | string | Group API ID to restrict to one group. |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_list_unsubscribed",
"title": "List unsubscribed contacts",
"description": "Contacts that opted out (names, mobile, custom fields, addedOn, unsubscribedOn, reason). Optional date range and group API id. FireText: /unsubscribed.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pp": {
"anyOf": [
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 25
},
{
"type": "number",
"const": 50
},
{
"type": "number",
"const": 100
}
],
"description": "Results per page: 10, 25 (default), 50 or 100."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^(\\d{4}-\\d{2}-\\d{2}|last)$",
"description": "Start date YYYY-MM-DD, or \"last\" for only what is new since the last access."
},
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number (1-based)."
},
"group": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,64}$",
"description": "Group API ID to restrict to one group."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "List unsubscribed contacts",
"readOnlyHint": true
}
}SMS keywords on the account (keywordID, number, keyword, reference). FireText: /keywords.
| Parameter | Type | Description |
|---|---|---|
| pp | any | Results per page: 10, 25 (default), 50 or 100. |
| page | integer | Page number (1-based). |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_list_keywords",
"title": "List keywords",
"description": "SMS keywords on the account (keywordID, number, keyword, reference). FireText: /keywords.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pp": {
"anyOf": [
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 25
},
{
"type": "number",
"const": 50
},
{
"type": "number",
"const": 100
}
],
"description": "Results per page: 10, 25 (default), 50 or 100."
},
"page": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Page number (1-based)."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "List keywords",
"readOnlyHint": true
}
}WRITE, SPENDS MONEY: sends a REAL SMS to real phones and uses the account's SMS credits (one credit per 160 GSM characters per recipient; long and unicode messages cost more). Cannot be undone. At most 10 recipients per call; no groups, templates, scheduling or repeats. Only call after the user confirmed the exact text, sender and numbers. FireText: /sendsms.
| Parameter | Type | Description |
|---|---|---|
| to * | array | Recipient mobile numbers (1-10): UK 07... / 447..., or international without + and leading zeros. |
| from * | string | Sender ID shown on the handset: 3-11 characters, letters and digits only (a company name or a reply number). |
| message * | string | Message text (UTF-8), up to 612 characters (160 per single GSM SMS, 153 per part when longer; unicode 70/66). |
| unicode | any | 0 = GSM characters only (default), 1 = always unicode, 2 = auto-detect from the text. |
| reference | string | Optional custom reference stored against the message (usable in firetext_get_delivery_report). |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
WRITE: adds a contact (by mobile number) to the FireText account, optionally into a group, or with update=true refreshes the names/custom fields of an existing contact. Does not send any SMS. A contact that opted out cannot be re-added this way (they must rejoin by SMS). FireText: /subscribe.
| Parameter | Type | Description |
|---|---|---|
| group | string | Group API ID to add the contact to. |
| mobile * | string | Mobile number: UK 07700900123 / 447700900123, or international without + and leading zeros (e.g. 33612345678). |
| update | boolean | true = overwrite firstname, lastname and custom1-3 of an existing contact. |
| custom1 | string | |
| custom2 | string | |
| custom3 | string | |
| lastname | string | |
| firstname | string | |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
WRITE: opts a contact out of the FireText account (all groups by default), so it no longer receives group messages. The contact can only rejoin by SMS. Does not send any SMS. FireText: /unsubscribe.
| Parameter | Type | Description |
|---|---|---|
| group | string | Group API ID, only if the account unsubscribes per group. |
| mobile * | string | Mobile number: UK 07700900123 / 447700900123, or international without + and leading zeros (e.g. 33612345678). |
| subaccount | string | Sub-account ID (only when the account has the sub-account module). Omit for the main account. |
{
"name": "firetext_unsubscribe_contact",
"title": "Unsubscribe contact",
"description": "WRITE: opts a contact out of the FireText account (all groups by default), so it no longer receives group messages. The contact can only rejoin by SMS. Does not send any SMS. FireText: /unsubscribe.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mobile"
],
"properties": {
"group": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,64}$",
"description": "Group API ID, only if the account unsubscribes per group."
},
"mobile": {
"type": "string",
"maxLength": 32,
"minLength": 1,
"description": "Mobile number: UK 07700900123 / 447700900123, or international without + and leading zeros (e.g. 33612345678)."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "Unsubscribe contact",
"destructiveHint": true
}
}Tools for FireText, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many SMS credits do I have left on my account today?"; "How many texts did I send last month and how many credits did they use?"; "Who has opted out of receiving my text messages so far?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes FireText data. Free plan: 50 tool calls per month. Run firetext_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run firetext_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run firetext_upgrade without a plan: it returns both plans, each with a payment link for the user to open. firetext_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "firetext_send_sms",
"title": "Send SMS",
"description": "WRITE, SPENDS MONEY: sends a REAL SMS to real phones and uses the account's SMS credits (one credit per 160 GSM characters per recipient; long and unicode messages cost more). Cannot be undone. At most 10 recipients per call; no groups, templates, scheduling or repeats. Only call after the user confirmed the exact text, sender and numbers. FireText: /sendsms.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"to",
"message",
"from"
],
"properties": {
"to": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32,
"minLength": 1,
"description": "Mobile number: UK 07700900123 / 447700900123, or international without + and leading zeros (e.g. 33612345678)."
},
"maxItems": 10,
"minItems": 1,
"description": "Recipient mobile numbers (1-10): UK 07... / 447..., or international without + and leading zeros."
},
"from": {
"type": "string",
"pattern": "^[A-Za-z0-9]{3,11}$",
"description": "Sender ID shown on the handset: 3-11 characters, letters and digits only (a company name or a reply number)."
},
"message": {
"type": "string",
"maxLength": 612,
"minLength": 1,
"description": "Message text (UTF-8), up to 612 characters (160 per single GSM SMS, 153 per part when longer; unicode 70/66)."
},
"unicode": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
}
],
"description": "0 = GSM characters only (default), 1 = always unicode, 2 = auto-detect from the text."
},
"reference": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Optional custom reference stored against the message (usable in firetext_get_delivery_report)."
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "Send SMS",
"destructiveHint": true
}
}{
"name": "firetext_subscribe_contact",
"title": "Add or update contact",
"description": "WRITE: adds a contact (by mobile number) to the FireText account, optionally into a group, or with update=true refreshes the names/custom fields of an existing contact. Does not send any SMS. A contact that opted out cannot be re-added this way (they must rejoin by SMS). FireText: /subscribe.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mobile"
],
"properties": {
"group": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,64}$",
"description": "Group API ID to add the contact to."
},
"mobile": {
"type": "string",
"maxLength": 32,
"minLength": 1,
"description": "Mobile number: UK 07700900123 / 447700900123, or international without + and leading zeros (e.g. 33612345678)."
},
"update": {
"type": "boolean",
"description": "true = overwrite firstname, lastname and custom1-3 of an existing contact."
},
"custom1": {
"type": "string",
"maxLength": 255
},
"custom2": {
"type": "string",
"maxLength": 255
},
"custom3": {
"type": "string",
"maxLength": 255
},
"lastname": {
"type": "string",
"maxLength": 100
},
"firstname": {
"type": "string",
"maxLength": 100
},
"subaccount": {
"type": "string",
"pattern": "^[A-Za-z0-9_.@-]{1,64}$",
"description": "Sub-account ID (only when the account has the sub-account module). Omit for the main account."
}
}
},
"annotations": {
"title": "Add or update contact",
"destructiveHint": true
}
}