Sociocs MCP by usefulapi

List contacts and messages, send texts and delete scheduled messages in Sociocs.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
75%
Naming quality
75%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (4)

  • LOWTool 'sociocs_list_unreplied_messages' name length outside 3-30 rangein sociocs_list_unreplied_messages
  • LOWTool 'sociocs_list_scheduled_messages' name length outside 3-30 rangein sociocs_list_scheduled_messages
  • LOWTool 'sociocs_list_webhook_subscriptions' name length outside 3-30 rangein sociocs_list_webhook_subscriptions
  • LOWTool 'sociocs_delete_scheduled_message' name length outside 3-30 rangein sociocs_delete_scheduled_message

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,263Tokens (tool definitions)
~926 BTypical response size
Moderate attention impact (1.77% of 128k context)

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-http

What it can do

Tool inventory

Tools (15)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded15 tools