SlickText MCP by usefulapi is an MCP server published by io.usefulapi, hosted at slicktext.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 24 tools, including slicktext_get_brand, slicktext_get_credit_usage, slicktext_list_contacts, slicktext_find_contact, slicktext_get_contact.
Read SlickText contacts, lists, campaigns, analytics and inbox; create and update contacts.
4,170 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the SlickText brand this API key belongs to: brand_id, name, website, sending-number registration details, opt-in / double-opt-in messages, inbox settings and the message credit limit. Every other tool works within this brand. GET /brands.
No parameters.
{
"name": "slicktext_get_brand",
"title": "Get the brand",
"description": "Get the SlickText brand this API key belongs to: brand_id, name, website, sending-number registration details, opt-in / double-opt-in messages, inbox settings and the message credit limit. Every other tool works within this brand. GET /brands.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the brand",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
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.
Message credits for the current billing period: total_credits (subscription + rollover + purchased), credits_used, credits_available and the credit limit. GET /brands/{brand_id}/usage.
No parameters.
{
"name": "slicktext_get_credit_usage",
"title": "Get message credit usage",
"description": "Message credits for the current billing period: total_credits (subscription + rollover + purchased), credits_used, credits_available and the credit limit. GET /brands/{brand_id}/usage.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get message credit usage",
"readOnlyHint": true
}
}List the brand's contacts (subscribers) with name, mobile_number, email, opt_in_status, source, custom_fields and dates. Filters are exact, case-sensitive matches (SlickText has no partial search). Paged: returns count, has_more and next_offset. GET /brands/{brand_id}/contacts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
| last_name | string | Exact last name (case-sensitive). |
| first_name | string | Exact first name (case-sensitive). |
| custom_fields | object | Exact-match filters on custom fields, keyed by internal_name (see slicktext_list_custom_fields), e.g. {"favorite_color": "blue"}. |
| opt_in_status | string | Only contacts with this opt-in status. |
{
"name": "slicktext_list_contacts",
"title": "List contacts",
"description": "List the brand's contacts (subscribers) with name, mobile_number, email, opt_in_status, source, custom_fields and dates. Filters are exact, case-sensitive matches (SlickText has no partial search). Paged: returns count, has_more and next_offset. GET /brands/{brand_id}/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
},
"last_name": {
"type": "string",
"maxLength": 255,
"description": "Exact last name (case-sensitive)."
},
"first_name": {
"type": "string",
"maxLength": 255,
"description": "Exact first name (case-sensitive)."
},
"custom_fields": {
"type": "object",
"description": "Exact-match filters on custom fields, keyed by internal_name (see slicktext_list_custom_fields), e.g. {\"favorite_color\": \"blue\"}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"opt_in_status": {
"enum": [
"not subscribed",
"subscribed",
"unsubscribed",
"blocked"
],
"type": "string",
"description": "Only contacts with this opt-in status."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true
}
}Find contacts by mobile number or email address (exact match). A 10-digit US number is matched as +1XXXXXXXXXX, the way SlickText stores numbers. Use it before creating a contact to avoid duplicates. GET /brands/{brand_id}/contacts?mobile_number=… or ?email=….
| Parameter | Type | Description |
|---|---|---|
| string | Exact email address (case-sensitive, as stored). | |
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
| mobile_number | string | Mobile number, e.g. +16155553338 or (615) 555-3338. |
{
"name": "slicktext_find_contact",
"title": "Find a contact by phone or email",
"description": "Find contacts by mobile number or email address (exact match). A 10-digit US number is matched as +1XXXXXXXXXX, the way SlickText stores numbers. Use it before creating a contact to avoid duplicates. GET /brands/{brand_id}/contacts?mobile_number=… or ?email=….",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"maxLength": 254,
"minLength": 3,
"description": "Exact email address (case-sensitive, as stored)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
},
"mobile_number": {
"type": "string",
"maxLength": 32,
"minLength": 7,
"description": "Mobile number, e.g. +16155553338 or (615) 555-3338."
}
}
},
"annotations": {
"title": "Find a contact by phone or email",
"readOnlyHint": true
}
}Get one contact by id: name, mobile_number, email, birthdate, address, opt_in_status, source, custom_fields, time zone and dates. GET /brands/{brand_id}/contacts/{id}.
| Parameter | Type | Description |
|---|---|---|
| contact_id * | integer | The contact id (a positive integer). |
{
"name": "slicktext_get_contact",
"title": "Get a contact",
"description": "Get one contact by id: name, mobile_number, email, birthdate, address, opt_in_status, source, custom_fields, time zone and dates. GET /brands/{brand_id}/contacts/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The contact id (a positive integer).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a contact",
"readOnlyHint": true
}
}List the brand's contact custom fields: name, internal_name (the key used in contact filters and writes), data_type and description. GET /brands/{brand_id}/custom-fields.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
{
"name": "slicktext_list_custom_fields",
"title": "List custom fields",
"description": "List the brand's contact custom fields: name, internal_name (the key used in contact filters and writes), data_type and description. GET /brands/{brand_id}/custom-fields.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
}
}
},
"annotations": {
"title": "List custom fields",
"readOnlyHint": true
}
}List the brand's contact lists (contact_list_id, name, description, created). Optional exact name filter. GET /brands/{brand_id}/lists.
| Parameter | Type | Description |
|---|---|---|
| name | string | Exact list name (case-sensitive). |
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
{
"name": "slicktext_list_lists",
"title": "List contact lists",
"description": "List the brand's contact lists (contact_list_id, name, description, created). Optional exact name filter. GET /brands/{brand_id}/lists.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"description": "Exact list name (case-sensitive)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
}
}
},
"annotations": {
"title": "List contact lists",
"readOnlyHint": true
}
}Get one contact list by id plus its contact count (all statuses: subscribed, not subscribed, unsubscribed, blocked). GET /brands/{brand_id}/lists/{id} and /lists/{id}/contacts/count.
| Parameter | Type | Description |
|---|---|---|
| list_id * | integer | The contact list id (a positive integer). |
{
"name": "slicktext_get_list",
"title": "Get a contact list",
"description": "Get one contact list by id plus its contact count (all statuses: subscribed, not subscribed, unsubscribed, blocked). GET /brands/{brand_id}/lists/{id} and /lists/{id}/contacts/count.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"list_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The contact list id (a positive integer).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a contact list",
"readOnlyHint": true
}
}List the contacts in one contact list (paged). GET /brands/{brand_id}/lists/{id}/contacts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
| list_id * | integer | The contact list id (a positive integer). |
| opt_in_status | string | Only contacts with this opt-in status. |
{
"name": "slicktext_list_list_contacts",
"title": "List contacts in a list",
"description": "List the contacts in one contact list (paged). GET /brands/{brand_id}/lists/{id}/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
},
"list_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The contact list id (a positive integer).",
"exclusiveMinimum": 0
},
"opt_in_status": {
"enum": [
"not subscribed",
"subscribed",
"unsubscribed",
"blocked"
],
"type": "string",
"description": "Only contacts with this opt-in status."
}
}
},
"annotations": {
"title": "List contacts in a list",
"readOnlyHint": true
}
}List the brand's segments (rule-based contact groups: segment_id, name, description). GET /brands/{brand_id}/segments.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
{
"name": "slicktext_list_segments",
"title": "List segments",
"description": "List the brand's segments (rule-based contact groups: segment_id, name, description). GET /brands/{brand_id}/segments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
}
}
},
"annotations": {
"title": "List segments",
"readOnlyHint": true
}
}List the contacts that currently match one segment (paged). GET /brands/{brand_id}/segments/{id}/contacts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
| segment_id * | integer | The segment id (a positive integer). |
{
"name": "slicktext_list_segment_contacts",
"title": "List contacts in a segment",
"description": "List the contacts that currently match one segment (paged). GET /brands/{brand_id}/segments/{id}/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"segment_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
},
"segment_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The segment id (a positive integer).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List contacts in a segment",
"readOnlyHint": true
}
}List the brand's SMS/MMS campaigns: name, body, status (e.g. draft, scheduled, queued, sent), scheduled/started/finished times, completion_percentage and audience (lists/segments and size). GET /brands/{brand_id}/campaigns.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
| status | string | Exact status, e.g. "sent", "scheduled", "draft". |
{
"name": "slicktext_list_campaigns",
"title": "List campaigns",
"description": "List the brand's SMS/MMS campaigns: name, body, status (e.g. draft, scheduled, queued, sent), scheduled/started/finished times, completion_percentage and audience (lists/segments and size). GET /brands/{brand_id}/campaigns.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
},
"status": {
"type": "string",
"maxLength": 32,
"description": "Exact status, e.g. \"sent\", \"scheduled\", \"draft\"."
}
}
},
"annotations": {
"title": "List campaigns",
"readOnlyHint": true
}
}Get one campaign by id: body, media_url, status, audience_size, schedule and completion. GET /brands/{brand_id}/campaigns/{id}.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | integer | The campaign id (a positive integer). |
{
"name": "slicktext_get_campaign",
"title": "Get a campaign",
"description": "Get one campaign by id: body, media_url, status, audience_size, schedule and completion. GET /brands/{brand_id}/campaigns/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The campaign id (a positive integer).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a campaign",
"readOnlyHint": true
}
}Performance of one campaign: contacts reached, clicks, click_rate, unique clicks, unsubscribes, unsubscribe_rate, orders, revenue, average order value, revenue per message, plus the campaign, its audiences and links. GET /brands/{brand_id}/analytics/campaigns/{id}.
| Parameter | Type | Description |
|---|---|---|
| group | string | Group the results by source. |
| campaign_id * | integer | The campaign id (a positive integer). |
{
"name": "slicktext_get_campaign_stats",
"title": "Get campaign performance",
"description": "Performance of one campaign: contacts reached, clicks, click_rate, unique clicks, unsubscribes, unsubscribe_rate, orders, revenue, average order value, revenue per message, plus the campaign, its audiences and links. GET /brands/{brand_id}/analytics/campaigns/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"group": {
"enum": [
"source"
],
"type": "string",
"description": "Group the results by source."
},
"campaign_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The campaign id (a positive integer).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get campaign performance",
"readOnlyHint": true
}
}Brand-level analytics. metric: contacts (current totals), contact_growth, contact_add_delete_events, opt_in_status_events, campaigns, messages (messages sent), message_credits, inbox_users (assignments, closures, response times per user), inbox_tags. Optional group (allowed per metric — contacts: source|opt_in_status; contact_growth/campaigns: contact_source; contact_add_delete_events: contact_source|type; opt_in_status_events: contact_source|contact_unsubscribe_source|opt_in_status; messages: source|status|direction|weekday; message_credits: source|status), a start/end range, frequency (hour/day/month/year) and compare (YoY, QoQ, MoM, WoW, DoD, PoP). GET /brands/{brand_id}/analytics/….
| Parameter | Type | Description |
|---|---|---|
| end | string | Range end, YYYY-MM-DD (= end of that day) or YYYY-MM-DD HH:MM[:SS] (SlickText's format, no time zone (passed through as is)). |
| group | string | Group results by this field (allowed values depend on metric; see description). |
| start | string | Range start, YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS] (SlickText's format, no time zone (passed through as is)). |
| metric * | string | Which analytics report. |
| compare | string | Compare with the previous period. |
| frequency | string | Bucket size of the time series. |
{
"name": "slicktext_get_analytics",
"title": "Get brand analytics",
"description": "Brand-level analytics. metric: contacts (current totals), contact_growth, contact_add_delete_events, opt_in_status_events, campaigns, messages (messages sent), message_credits, inbox_users (assignments, closures, response times per user), inbox_tags. Optional group (allowed per metric — contacts: source|opt_in_status; contact_growth/campaigns: contact_source; contact_add_delete_events: contact_source|type; opt_in_status_events: contact_source|contact_unsubscribe_source|opt_in_status; messages: source|status|direction|weekday; message_credits: source|status), a start/end range, frequency (hour/day/month/year) and compare (YoY, QoQ, MoM, WoW, DoD, PoP). GET /brands/{brand_id}/analytics/….",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"metric"
],
"properties": {
"end": {
"type": "string",
"maxLength": 32,
"description": "Range end, YYYY-MM-DD (= end of that day) or YYYY-MM-DD HH:MM[:SS] (SlickText's format, no time zone (passed through as is))."
},
"group": {
"type": "string",
"maxLength": 64,
"description": "Group results by this field (allowed values depend on metric; see description)."
},
"start": {
"type": "string",
"maxLength": 32,
"description": "Range start, YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS] (SlickText's format, no time zone (passed through as is))."
},
"metric": {
"enum": [
"contacts",
"contact_growth",
"contact_add_delete_events",
"opt_in_status_events",
"campaigns",
"messages",
"message_credits",
"inbox_users",
"inbox_tags"
],
"type": "string",
"description": "Which analytics report."
},
"compare": {
"enum": [
"YoY",
"QoQ",
"MoM",
"WoW",
"DoD",
"PoP"
],
"type": "string",
"description": "Compare with the previous period."
},
"frequency": {
"enum": [
"hour",
"day",
"month",
"year"
],
"type": "string",
"description": "Bucket size of the time series."
}
}
},
"annotations": {
"title": "Get brand analytics",
"readOnlyHint": true
}
}List the brand's text-to-join keywords (word, description, active, auto-response and opt-in messages, double opt-in). GET /brands/{brand_id}/keywords.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 25). |
| active | boolean | true = only active keywords, false = only inactive. |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
{
"name": "slicktext_list_keywords",
"title": "List keywords",
"description": "List the brand's text-to-join keywords (word, description, active, auto-response and opt-in messages, double opt-in). GET /brands/{brand_id}/keywords.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"active": {
"type": "boolean",
"description": "true = only active keywords, false = only inactive."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
}
}
},
"annotations": {
"title": "List keywords",
"readOnlyHint": true
}
}Get one keyword by id, including the contact_list_ids that people who text it are added to. GET /brands/{brand_id}/keywords/{id}.
| Parameter | Type | Description |
|---|---|---|
| keyword_id * | integer | The keyword id (a positive integer). |
{
"name": "slicktext_get_keyword",
"title": "Get a keyword",
"description": "Get one keyword by id, including the contact_list_ids that people who text it are added to. GET /brands/{brand_id}/keywords/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keyword_id"
],
"properties": {
"keyword_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The keyword id (a positive integer).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a keyword",
"readOnlyHint": true
}
}List individual SMS/MMS messages sent and received by the brand: to, from, body, direction, source (Campaign, Keyword, InboxThread, API …), status (delivered, undelivered …), credits and the contact. Filters are exact matches; use to/from with a phone number to read one contact's history, or source=InboxThread with source_id = a conversation id. GET /brands/{brand_id}/messages.
| Parameter | Type | Description |
|---|---|---|
| to | string | Recipient number (outgoing messages: the contact; incoming: your number). |
| from | string | Sender number (incoming messages: the contact; outgoing: your number). |
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
| source | string | Exact source, e.g. "Campaign", "Keyword", "InboxThread", "API". |
| status | string | Exact status, e.g. "delivered", "undelivered". |
| direction | string | one of ["incoming","outgoing"] |
| source_id | string | Id of the source (a campaign id, a conversation id …). |
{
"name": "slicktext_list_messages",
"title": "List messages",
"description": "List individual SMS/MMS messages sent and received by the brand: to, from, body, direction, source (Campaign, Keyword, InboxThread, API …), status (delivered, undelivered …), credits and the contact. Filters are exact matches; use to/from with a phone number to read one contact's history, or source=InboxThread with source_id = a conversation id. GET /brands/{brand_id}/messages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": "string",
"maxLength": 32,
"minLength": 7,
"description": "Recipient number (outgoing messages: the contact; incoming: your number)."
},
"from": {
"type": "string",
"maxLength": 32,
"minLength": 7,
"description": "Sender number (incoming messages: the contact; outgoing: your number)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
},
"source": {
"type": "string",
"maxLength": 32,
"description": "Exact source, e.g. \"Campaign\", \"Keyword\", \"InboxThread\", \"API\"."
},
"status": {
"type": "string",
"maxLength": 32,
"description": "Exact status, e.g. \"delivered\", \"undelivered\"."
},
"direction": {
"enum": [
"incoming",
"outgoing"
],
"type": "string"
},
"source_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Id of the source (a campaign id, a conversation id …)."
}
}
},
"annotations": {
"title": "List messages",
"readOnlyHint": true
}
}List two-way inbox conversations: status (open, pending, closed), the contact, the last message and its direction/time, assigned user, tags and unread state. GET /brands/{brand_id}/inbox-threads.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
| status | string | one of ["open","pending","closed"] |
| assigned_to_user_id | integer | Only conversations assigned to this user id. |
{
"name": "slicktext_list_conversations",
"title": "List inbox conversations",
"description": "List two-way inbox conversations: status (open, pending, closed), the contact, the last message and its direction/time, assigned user, tags and unread state. GET /brands/{brand_id}/inbox-threads.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
},
"status": {
"enum": [
"open",
"pending",
"closed"
],
"type": "string"
},
"assigned_to_user_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only conversations assigned to this user id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List inbox conversations",
"readOnlyHint": true
}
}Get the content of one inbox conversation by its id (the _id from slicktext_list_conversations). For the message-by-message history also call slicktext_list_messages with source=InboxThread and source_id=<conversation id>. GET /brands/{brand_id}/inbox-threads/{id}/content.
| Parameter | Type | Description |
|---|---|---|
| conversation_id * | string | The conversation _id, e.g. 6744a2ba587c8f2cf4028786. |
{
"name": "slicktext_get_conversation",
"title": "Get an inbox conversation",
"description": "Get the content of one inbox conversation by its id (the _id from slicktext_list_conversations). For the message-by-message history also call slicktext_list_messages with source=InboxThread and source_id=<conversation id>. GET /brands/{brand_id}/inbox-threads/{id}/content.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id"
],
"properties": {
"conversation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9]{1,64}$",
"description": "The conversation _id, e.g. 6744a2ba587c8f2cf4028786."
}
}
},
"annotations": {
"title": "Get an inbox conversation",
"readOnlyHint": true
}
}List the inbox tags used to label conversations (inbox_tag_id, name, color, description). GET /brands/{brand_id}/inbox-tags.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 25). |
| offset | integer | Number of results to skip (default 0). Use next_offset from the previous page. |
{
"name": "slicktext_list_inbox_tags",
"title": "List inbox tags",
"description": "List the inbox tags used to label conversations (inbox_tag_id, name, color, description). GET /brands/{brand_id}/inbox-tags.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 25)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Use next_offset from the previous page."
}
}
},
"annotations": {
"title": "List inbox tags",
"readOnlyHint": true
}
}WRITE: add a contact to the brand. By default the contact is created as 'not subscribed' and gets no text. Set opt_in_status='subscribed' ONLY for people who gave explicit permission to receive texts (SlickText has a zero-tolerance policy for unsolicited texts). force_double_opt_in=true makes SlickText SEND A REAL SMS to the number asking the person to confirm. Check slicktext_find_contact first to avoid duplicates. WARNING: SlickText workflows can trigger on this event (Contact Created / Contact Field Changed / Contact Added to List) and may immediately SEND REAL TEXTS or take other actions configured in the brand's workflows. POST /brands/{brand_id}/contacts.
| Parameter | Type | Description |
|---|---|---|
| zip | string | |
| city | string | |
| string | ||
| state | string | |
| address | string | |
| country | string | |
| language | string | Primary language code, e.g. "en". |
| timezone | string | Contact time zone (SlickText accepts these four). |
| birthdate | string | Birthday, YYYY-MM-DD. |
| last_name | string | |
| first_name | string | |
| custom_fields | object | Custom field values keyed by the field's internal_name (see slicktext_list_custom_fields), e.g. {"favorite_color": "blue"}. |
| mobile_number * | string | Mobile number (required), e.g. +16155553338 or (615) 555-3338. |
| opt_in_status | string | Default 'not subscribed'. 'subscribed' only with the person's explicit consent. |
| force_double_opt_in | boolean | true = SlickText texts the number a double opt-in confirmation (a real SMS). |
{
"name": "slicktext_create_contact",
"title": "Create a contact",
"description": "WRITE: add a contact to the brand. By default the contact is created as 'not subscribed' and gets no text. Set opt_in_status='subscribed' ONLY for people who gave explicit permission to receive texts (SlickText has a zero-tolerance policy for unsolicited texts). force_double_opt_in=true makes SlickText SEND A REAL SMS to the number asking the person to confirm. Check slicktext_find_contact first to avoid duplicates. WARNING: SlickText workflows can trigger on this event (Contact Created / Contact Field Changed / Contact Added to List) and may immediately SEND REAL TEXTS or take other actions configured in the brand's workflows. POST /brands/{brand_id}/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mobile_number"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 16
},
"city": {
"type": "string",
"maxLength": 255
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
},
"state": {
"type": "string",
"maxLength": 64
},
"address": {
"type": "string",
"maxLength": 255
},
"country": {
"type": "string",
"maxLength": 64
},
"language": {
"type": "string",
"maxLength": 16,
"description": "Primary language code, e.g. \"en\"."
},
"timezone": {
"enum": [
"America/New_York",
"America/Chicago",
"America/Denver",
"America/Los_Angeles"
],
"type": "string",
"description": "Contact time zone (SlickText accepts these four)."
},
"birthdate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Birthday, YYYY-MM-DD."
},
"last_name": {
"type": "string",
"maxLength": 255
},
"first_name": {
"type": "string",
"maxLength": 255
},
"custom_fields": {
"type": "object",
"description": "Custom field values keyed by the field's internal_name (see slicktext_list_custom_fields), e.g. {\"favorite_color\": \"blue\"}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"mobile_number": {
"type": "string",
"maxLength": 32,
"minLength": 7,
"description": "Mobile number (required), e.g. +16155553338 or (615) 555-3338."
},
"opt_in_status": {
"enum": [
"not subscribed",
"subscribed",
"unsubscribed",
"blocked"
],
"type": "string",
"description": "Default 'not subscribed'. 'subscribed' only with the person's explicit consent."
},
"force_double_opt_in": {
"type": "boolean",
"description": "true = SlickText texts the number a double opt-in confirmation (a real SMS)."
}
}
},
"annotations": {
"title": "Create a contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: change fields of an existing contact (only the fields you pass are sent). opt_in_status can mark a contact unsubscribed or blocked; set it to 'subscribed' ONLY when the person explicitly agreed to receive texts. WARNING: SlickText workflows can trigger on this event (Contact Created / Contact Field Changed / Contact Added to List) and may immediately SEND REAL TEXTS or take other actions configured in the brand's workflows. PUT /brands/{brand_id}/contacts/{id}.
| Parameter | Type | Description |
|---|---|---|
| zip | string | |
| city | string | |
| string | ||
| state | string | |
| address | string | |
| country | string | |
| language | string | Primary language code, e.g. "en". |
| timezone | string | Contact time zone (SlickText accepts these four). |
| birthdate | string | Birthday, YYYY-MM-DD. |
| last_name | string | |
| contact_id * | integer | The contact id (a positive integer). |
| first_name | string | |
| custom_fields | object | Custom field values keyed by the field's internal_name (see slicktext_list_custom_fields), e.g. {"favorite_color": "blue"}. |
| mobile_number | string | New mobile number. |
| opt_in_status | string | New opt-in status. 'subscribed' only with the person's explicit consent. |
{
"name": "slicktext_update_contact",
"title": "Update a contact",
"description": "WRITE: change fields of an existing contact (only the fields you pass are sent). opt_in_status can mark a contact unsubscribed or blocked; set it to 'subscribed' ONLY when the person explicitly agreed to receive texts. WARNING: SlickText workflows can trigger on this event (Contact Created / Contact Field Changed / Contact Added to List) and may immediately SEND REAL TEXTS or take other actions configured in the brand's workflows. PUT /brands/{brand_id}/contacts/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 16
},
"city": {
"type": "string",
"maxLength": 255
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
},
"state": {
"type": "string",
"maxLength": 64
},
"address": {
"type": "string",
"maxLength": 255
},
"country": {
"type": "string",
"maxLength": 64
},
"language": {
"type": "string",
"maxLength": 16,
"description": "Primary language code, e.g. \"en\"."
},
"timezone": {
"enum": [
"America/New_York",
"America/Chicago",
"America/Denver",
"America/Los_Angeles"
],
"type": "string",
"description": "Contact time zone (SlickText accepts these four)."
},
"birthdate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Birthday, YYYY-MM-DD."
},
"last_name": {
"type": "string",
"maxLength": 255
},
"contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The contact id (a positive integer).",
"exclusiveMinimum": 0
},
"first_name": {
"type": "string",
"maxLength": 255
},
"custom_fields": {
"type": "object",
"description": "Custom field values keyed by the field's internal_name (see slicktext_list_custom_fields), e.g. {\"favorite_color\": \"blue\"}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"mobile_number": {
"type": "string",
"maxLength": 32,
"minLength": 7,
"description": "New mobile number."
},
"opt_in_status": {
"enum": [
"not subscribed",
"subscribed",
"unsubscribed",
"blocked"
],
"type": "string",
"description": "New opt-in status. 'subscribed' only with the person's explicit consent."
}
}
},
"annotations": {
"title": "Update a contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: add one contact to one or more contact lists (it does not change the contact's opt-in status; lists are also campaign audiences). Returns SlickText's count of memberships added. WARNING: SlickText workflows can trigger on this event (Contact Created / Contact Field Changed / Contact Added to List) and may immediately SEND REAL TEXTS or take other actions configured in the brand's workflows. POST /brands/{brand_id}/lists/contacts.
| Parameter | Type | Description |
|---|---|---|
| list_ids * | array | Contact list ids (from slicktext_list_lists). |
| contact_id * | integer | The contact id (a positive integer). |
{
"name": "slicktext_add_contact_to_lists",
"title": "Add a contact to lists",
"description": "WRITE: add one contact to one or more contact lists (it does not change the contact's opt-in status; lists are also campaign audiences). Returns SlickText's count of memberships added. WARNING: SlickText workflows can trigger on this event (Contact Created / Contact Field Changed / Contact Added to List) and may immediately SEND REAL TEXTS or take other actions configured in the brand's workflows. POST /brands/{brand_id}/lists/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id",
"list_ids"
],
"properties": {
"list_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 20,
"minItems": 1,
"description": "Contact list ids (from slicktext_list_lists)."
},
"contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The contact id (a positive integer).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Add a contact to lists",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for SlickText, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many credits do I have left this billing period?"; "Show clicks and unsubscribes for text campaign ID 1042."; "How many contacts are on my VIP list, counting all statuses?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes SlickText data. Free plan: 50 tool calls per month. Run slicktext_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 slicktext_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 slicktext_upgrade without a plan: it returns both plans, each with a payment link for the user to open. slicktext_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.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.