Sociocs MCP by usefulapi
List contacts and messages, send texts and delete scheduled messages in Sociocs.
Should I use this
Quality & Safety
Findings (4)
- LOWin sociocs_list_unreplied_messages
- LOWin sociocs_list_scheduled_messages
- LOWin sociocs_list_webhook_subscriptions
- LOWin sociocs_delete_scheduled_message
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"sociocs": {
"url": "https://sociocs.usefulapi.io/mcp"
}
}
}Remote endpoints
https://sociocs.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (15)
🟢sociocs_list_channels(provider)
List the sending channels (phone numbers) for one provider, with their channel_key. Use it first to find the channel_key that sociocs_send_message needs. Sociocs API: GET /channels.
Input Schema
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"tlnx",
"twlo",
"twlowa",
"gswa"
],
"description": "Messaging provider: tlnx (Telnyx SMS), twlo (Twilio SMS), twlowa (Twilio WhatsApp), gswa (Gupshup WhatsApp)."
}
},
"required": [
"provider"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_get_channel(channel_key)
Get one channel by its channel_key: name, phone number, country code and provider. Sociocs API: GET /channels/{channel_key}.
Input Schema
{
"type": "object",
"properties": {
"channel_key": {
"type": "string",
"minLength": 1,
"description": "Channel key from sociocs_list_channels."
}
},
"required": [
"channel_key"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_list_contact_lists
List all contact lists with their ids. Use an id as list_id in sociocs_list_contacts. Sociocs API: GET /lists.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_list_contacts(list_id, limit, offset)
List contacts from 'All Contacts' (list_id 0, the default) or from one contact list. Sociocs API: GET /contacts.
Input Schema
{
"type": "object",
"properties": {
"list_id": {
"description": "0 for All Contacts (default), or a contact list id.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Records to return, 1-1000 (default 1000).",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"offset": {
"description": "Number of records to skip (pagination).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_search_contacts(query, limit, offset)
Search contacts by part of a name or a phone number (case insensitive, at least 2 characters). Sociocs API: GET /contacts/search.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"description": "Part of the name or phone number."
},
"limit": {
"description": "Records to return, 1-20 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 20
},
"offset": {
"description": "Number of records to skip (pagination).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_get_contact(phone_number)
Get one contact by phone number, with the country code (with or without the leading plus). Sociocs API: GET /contacts/{phone_number}.
Input Schema
{
"type": "object",
"properties": {
"phone_number": {
"type": "string",
"minLength": 5,
"description": "Phone number with country code, e.g. +16175551212."
}
},
"required": [
"phone_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_list_messages(start_date, end_date)
List all messages between start_date and end_date (inclusive; at most 31 days apart; default today). Sociocs API: GET /messages.
Input Schema
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date in YYYY-MM-DD format."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date in YYYY-MM-DD format."
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_search_messages(text, direction, start_date, end_date)
Search message text. Filter by direction (incoming, outbound or both; default both) and dates (default: the last 90 days). Sociocs API: GET /messages/search.
Input Schema
{
"type": "object",
"properties": {
"text": {
"type": "string",
"minLength": 1,
"description": "Search term."
},
"direction": {
"description": "Which messages to search (default both).",
"type": "string",
"enum": [
"incoming",
"outbound",
"both"
]
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date in YYYY-MM-DD format."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date in YYYY-MM-DD format."
}
},
"required": [
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_list_unreplied_messages(start_date, end_date)
List incoming messages that have no reply, from the last 90 days by default. Good for finding customers who are waiting. Sociocs API: GET /messages/unreplied.
Input Schema
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date in YYYY-MM-DD format."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date in YYYY-MM-DD format."
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_list_scheduled_messages
List up to 100 scheduled messages, newest scheduled date first. There is no pagination. Sociocs API: GET /messages/scheduled.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_list_bulk_jobs
List up to 100 bulk messaging jobs, newest scheduled date first. There is no pagination. Sociocs API: GET /messages/bulk.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_list_team_members
List the team members of the account with their user ids (use one as user_id in sociocs_send_message). Sociocs API: GET /team-members.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sociocs_list_webhook_subscriptions
List the webhook subscriptions (endpoints that receive incoming messages or status updates). Sociocs API: GET /webhook-subscriptions.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴sociocs_send_message(provider, channel_key, to, name, text, ...)
SENDS a real SMS or WhatsApp message to a real phone number, now or at a future schedule time. Not reversible. Give at least one of text, image_url, video_url or file_url. WhatsApp messages outside the 24-hour window need a template, which this tool does not send. Sociocs API: POST /message.
Input Schema
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"gswa",
"sh",
"tlnx",
"twlo",
"twlowa"
],
"description": "Provider: gswa (Gupshup WhatsApp), sh (Signal House SMS), tlnx (Telnyx SMS), twlo (Twilio SMS), twlowa (Twilio WhatsApp)."
},
"channel_key": {
"type": "string",
"minLength": 1,
"description": "Channel key from sociocs_list_channels."
},
"to": {
"type": "string",
"minLength": 5,
"description": "Recipient phone number with country code, e.g. +16175551212."
},
"name": {
"description": "Recipient name.",
"type": "string"
},
"text": {
"description": "Message text.",
"type": "string"
},
"image_url": {
"description": "Publicly reachable image URL.",
"type": "string",
"format": "uri"
},
"video_url": {
"description": "Publicly reachable video URL.",
"type": "string",
"format": "uri"
},
"file_url": {
"description": "Publicly reachable file URL.",
"type": "string",
"format": "uri"
},
"schedule": {
"description": "ISO 8601 date and time for a future send, e.g. 2026-12-01T09:00:00+01:00. Omit to send now.",
"type": "string"
},
"user_id": {
"description": "Team member id shown as the sender (from sociocs_list_team_members).",
"type": "string"
}
},
"required": [
"provider",
"channel_key",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴sociocs_delete_scheduled_message(message_id)
Delete a scheduled message that has not been sent yet. A message that is already sending or sent cannot be deleted. Sociocs API: DELETE /messages/scheduled/{message_id}.
Input Schema
{
"type": "object",
"properties": {
"message_id": {
"type": "string",
"minLength": 1,
"description": "ID from sociocs_list_scheduled_messages."
}
},
"required": [
"message_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence