Sociocs MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.1.0Updated Nov 16, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executable

Overview

Sociocs MCP by usefulapi's hosted MCP server (sociocs.usefulapi.io), published by usefulapi.io; no sign-in required; Streamable HTTP; 15 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Publisher
usefulapi.io
Endpoint
sociocs.usefulapi.io
Last checked

Installation

In SourceWeft

  1. Open Sociocs MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fsociocs/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "sociocs-by-usefulapi": {
      "type": "http",
      "url": "https://sociocs.usefulapi.io/mcp"
    }
  }
}

README

Sociocs MCP by usefulapi

Use your Sociocs account from Claude, Cursor, or any MCP client. Read contacts and messages, send SMS or WhatsApp messages, and delete scheduled ones. Hosted, no local install: connect with your own credentials.

Live endpoint: https://sociocs.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://sociocs.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http sociocs https://sociocs.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "sociocs": {      "url": "https://sociocs.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Sociocs credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/sociocs/

On first connect you provide a Sociocs API key, found in Sociocs under Profile & settings → API. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
sociocs_list_channelsreadList channels
sociocs_get_channelreadGet a channel
sociocs_list_contact_listsreadList contact lists
sociocs_list_contactsreadList contacts
sociocs_search_contactsreadSearch contacts
sociocs_get_contactreadGet a contact
sociocs_list_messagesreadList messages by date
sociocs_search_messagesreadSearch messages
sociocs_list_unreplied_messagesreadList unreplied messages
sociocs_list_scheduled_messagesreadList scheduled messages
sociocs_list_bulk_jobsreadList bulk messaging jobs
sociocs_list_team_membersreadList team members
sociocs_list_webhook_subscriptionsreadList webhook subscriptions
sociocs_send_messagewriteSend a message
sociocs_delete_scheduled_messagewriteDelete a scheduled message
sociocs_usage_statusmetaUsage status (free-tier meter)
sociocs_request_featuremetaRequest a missing feature
sociocs_upgrademetaUpgrade to Pro or Pro+
sociocs_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run sociocs_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with sociocs_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with sociocs_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/sociocs/README.md at commit 0a017fd

Tools

15

sociocs_list_channels

List channels

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.

Parametersproviderrequired

sociocs_get_channel

Get a channel

Get one channel by its channel_key: name, phone number, country code and provider. Sociocs API: GET /channels/{channel_key}.

Parameterschannel_keyrequired

sociocs_list_contact_lists

List contact lists

List all contact lists with their ids. Use an id as list_id in sociocs_list_contacts. Sociocs API: GET /lists.

Takes no parameters.

sociocs_list_contacts

List contacts

List contacts from 'All Contacts' (list_id 0, the default) or from one contact list. Sociocs API: GET /contacts.

Parameterslimitoffsetlist_id

sociocs_search_contacts

Search contacts

Search contacts by part of a name or a phone number (case insensitive, at least 2 characters). Sociocs API: GET /contacts/search.

Parameterslimitqueryrequiredoffset

sociocs_get_contact

Get a contact

Get one contact by phone number, with the country code (with or without the leading plus). Sociocs API: GET /contacts/{phone_number}.

Parametersphone_numberrequired

sociocs_list_messages

List messages by date

List all messages between start_date and end_date (inclusive; at most 31 days apart; default today). Sociocs API: GET /messages.

Parametersend_datestart_date

sociocs_search_messages

Search messages

Search message text. Filter by direction (incoming, outbound or both; default both) and dates (default: the last 90 days). Sociocs API: GET /messages/search.

Parameterstextrequiredend_datedirectionstart_date

sociocs_list_unreplied_messages

List unreplied messages

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.

Parametersend_datestart_date

sociocs_list_scheduled_messages

List scheduled messages

List up to 100 scheduled messages, newest scheduled date first. There is no pagination. Sociocs API: GET /messages/scheduled.

Takes no parameters.

sociocs_list_bulk_jobs

List bulk messaging jobs

List up to 100 bulk messaging jobs, newest scheduled date first. There is no pagination. Sociocs API: GET /messages/bulk.

Takes no parameters.

sociocs_list_team_members

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.

Takes no parameters.

sociocs_list_webhook_subscriptions

List webhook subscriptions

List the webhook subscriptions (endpoints that receive incoming messages or status updates). Sociocs API: GET /webhook-subscriptions.

Takes no parameters.

sociocs_send_message

Send a message

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.

Parameterstorequirednametextuser_idfile_urlproviderrequiredscheduleimage_urlvideo_urlchannel_keyrequired

sociocs_delete_scheduled_message

Delete a scheduled message

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}.

Parametersmessage_idrequired

Version history

1
  1. v1.0.0Nov 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations