MCP: AI Assistants

Give Claude and other AI tools secure, controlled access to your mssgs workspace — locally, through your signed-in session.

Overview Connect Permissions & tokens Real-time events Tools

Webhooks & Integrations

Send messages and build interactive bots with webhooks and triggers.

Bot Messages

Rich embed cards, interactive buttons and live-updating messages.

Overview

The mssgs desktop app ships a built-in MCP server (Model Context Protocol), so AI assistants like Claude or Cursor can read and act in your workspace. It runs locally on your machine and talks to your logged-in mssgs session; no separate bot account or hosting needed.

You decide what it sees

The server runs on localhost only, while mssgs is open and you are signed in. You pick which channels to expose, and toggle on what the assistant may do, group by group. There are currently 77 tools across 10 groups.

Connect

MCP http://127.0.0.1:7444/mcp

Authenticated with a Bearer token from the app's AI / MCP settings page: enable the server, pick the channels to expose and press "Copy config"; the copied block already contains your port and token. The server listens on localhost only (default port 7444) and runs while mssgs is open and you are signed in.

Connect Claude Code 
claude mcp add --transport http mssgs http://127.0.0.1:7444/mcp \
  --header "Authorization: Bearer <your-token>"

For Claude Desktop or Cursor: paste the "Copy config" block into your AI tool's MCP settings. See the step-by-step guide in the help desk.

Permissions & tokens

The tools an assistant sees depend on the toggles you switch on. Read-only tools are always on; everything else sits behind a group toggle. Server management and moderation additionally check your real permissions on the account.

Group Unlocks
Reading Always on — read messages, presence, mentions and pins in exposed channels
Sending & interacting Send, reply, react, edit, delete, pin, typing — plus DM presence, voice calls and games
DM requests View, accept and deny incoming DM requests
Social Profiles, stories and your map filters
Server management Channels, categories, permission groups, webhooks and triggers — real manage permissions still enforced
Community moderation Review queues and votes — moderator or staff account still required
Keep computer awake Stop the machine sleeping while the assistant works
Bot account tools Interactive embed cards and their events — bot accounts only

Tokens

Tokens are named, per AI tool, and revocable in one click — with a per-token activity sparkline so you can see exactly when each was used. Good hygiene: one token per tool, named clearly. Lost laptop? Revoke its token and it is useless.

Real-time events over SSE

Open the MCP endpoint as a stream (GET /mcp with Accept: text/event-stream) and you receive JSON-RPC notifications as they happen:

Notification Fires on
notifications/mssgs/messageNew messages in channels you can see
notifications/mssgs/bot_eventButton presses, reactions and replies on messages your assistant posted via send_bot_message
notifications/mssgs/presencePresence changes
notifications/mssgs/typingTyping indicators
notifications/mssgs/callVoice call events

Interactive bot cards

Interactive bot cards from your assistant

Post an embed card with buttons via send_bot_message, listen for bot_event on the stream (or poll get_bot_events), and update the card in place with edit_message. Same card model as the bot messages docs.

Tool reference (77)

Every tool below is a real action in mssgs. Names are the exact MCP identifiers. Tools appear only once their group is switched on.

Reading

Always on

Read-only tools, available the moment the server is on. They only ever see the channels you exposed.

Tool What it does
list_channels List the channels you exposed to AI tools.
read_channel Read recent messages from an exposed channel.
get_new_messages Fetch messages newer than a timestamp across all exposed channels.
get_channel_stamp A channel's read/unread state, with unread and mention counts.
get_presence Who is present in a channel and their status.
get_message Get one full message by id, including embeds and link previews.
get_typing Who is currently typing in a channel.
list_mentions Recent messages that @mention you.
list_pinned_messages The pinned messages in a channel.
subscribe_channel Subscribe to a channel for realtime updates.
unsubscribe_channel Stop realtime updates for a channel.
list_subscriptions List the channels you are subscribed to for realtime.

Sending & interacting

Send toggle

Post and act as the signed-in user. Everything here writes to a channel, so it lives behind one toggle.

Tool What it does
send_message Send a message to a channel as you.
reply_message Reply to a specific message, threaded.
add_reaction Add an emoji reaction to a message.
remove_reaction Remove one of your emoji reactions.
edit_message Edit one of your own messages.
delete_message Delete one of your own messages.
pin_message Pin a message (requires pin permission).
unpin_message Unpin a pinned message.
open_one_view_attachment Open a view-once photo/video in a DM.
set_typing Show a live 'typing…' indicator.
stop_typing Clear the typing indicator.

DM presence & calls

Send toggle

Be present in a DM and place real voice calls — start_dm_call uses this computer's microphone, exactly as pressing call in the app.

Tool What it does
enter_dm_chat Show yourself as present in a DM.
leave_dm_chat Stop showing as present in a DM.
start_dm_call Start a voice call in a DM (uses this computer's mic).
answer_dm_call Answer a ringing DM call.
decline_dm_call Decline a ringing DM call.
end_dm_call Hang up or cancel a DM call.
get_call_status Current voice-call state and any incoming call.

Games

Send toggle

Join and play mssgs' built-in mini-games straight from your assistant.

Tool What it does
list_game_invites Open game invites addressed to you.
list_active_games Game rooms you are currently playing in.
accept_game_invite Accept an invite by room_id or join code.
get_game_state The live board/state of a game you are in.
game_move Play a turn in a game.
resign_game Forfeit or leave a game.

DM requests

DM requests toggle

Triage who is allowed to start a conversation with you.

Tool What it does
view_dm_requests Your open incoming DM requests.
accept_dm_request Accept a DM request.
deny_dm_request Deny a DM request.

Social: profiles, stories, map

Social toggle

Look up profiles, watch stories and see your submitted map filters.

Tool What it does
get_profile A user's public profile by user_guid.
list_story_users People with an unseen story you can view.
view_story View a user's active stories.
list_map_filters Map filters this account submitted, with their moderation state.

Bot account tools

Bot toggle · bot accounts only

Post interactive embed cards and read back the interactions on them. Available when signed in as a bot account.

Tool What it does
send_bot_message Post a rich embed card with optional buttons (bot accounts only).
get_bot_events Poll button presses, reactions and replies on your bot messages.
set_bot_status Set or clear a custom presence status (bot accounts only).

Server management

Server management toggle · needs manage permissions

Shape a server you manage: channels, categories, permission groups, webhooks and triggers. Every call still checks your real manage permissions on that server.

Tool What it does
list_manageable_servers Servers you can manage and which permissions you hold.
get_server_structure A server's full channel and category layout.
create_channel Create a channel.
update_channel Rename, retype or move a channel.
delete_channel Delete a channel (irreversible).
create_category Create a channel category.
update_category Rename a category.
delete_category Delete a category (its channels stay).
list_server_groups A server's permission groups.
create_server_group Create a permission group.
update_server_group Rename, recolor or re-scope a permission group.
delete_server_group Delete a permission group.
list_webhooks A server's inbound webhooks.
create_webhook Create an inbound webhook.
get_webhook_url Get a webhook's postable URL.
update_webhook Update a webhook's settings.
delete_webhook Delete a webhook (its URL stops working).
list_triggers A server's outbound triggers.
create_trigger Create a trigger (matching messages POST to a URL).
update_trigger Update a trigger.
delete_trigger Delete a trigger.

Community moderation

Moderation toggle · moderators/staff only

The same review queues the shield button opens in the app. Votes and vetoes still require a real moderator (or staff) account.

Tool What it does
get_moderation_stats Your moderation status and how much is waiting.
list_moderation_queue Map filters awaiting a moderator vote.
approve_map_filter Vote to approve a submitted map filter.
deny_map_filter Vote to deny a submitted map filter.
list_report_queue Reported content awaiting a moderator vote.
approve_report Vote that a report breaks the rules.
deny_report Vote that reported content is fine.
community_map_propose_filter Submit a new map filter for review.
veto_map_filter Staff-only: take a map filter down immediately (irreversible).

Utility

Keep-awake toggle

Small helpers for long-running assistants.

Tool What it does
keep_computer_awake Keep this computer awake while you work, or release it.

Questions?

We're happy to help you with your integration.

developers@mss.gs