Stoat MCP server

Connect Stoat to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Stoat MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the fetch server tool in Stoat
  • Use the manage reactions tool in Stoat
  • Use the delete messages tool in Stoat
  • Use the create server tool in Stoat
  • Use the fetch messages tool in Stoat
  • Use the edit server member tool in Stoat

Supported Tools

fetch_server

Fetch Server

Fetch details about a Stoat server including its name, description, channels, roles, and settings.

manage_reactions

Manage Reactions

Add, remove, or clear reactions on a message. Can add a single reaction, remove a specific user's reaction, remove all of one emoji, or clear all reactions on a message.

delete_messages

Delete Messages

Delete one or more messages from a Stoat channel. Provide a single message ID or an array of message IDs for bulk deletion. Requires appropriate permissions.

create_server

Create Server

Create a new Stoat server with a name and optional description.

fetch_messages

Fetch Messages

Fetch messages from a Stoat channel. Supports pagination with before/after cursors, sorting, and fetching a specific message by ID. Use this to read channel history or retrieve specific messages.

edit_member

Edit Server Member

Edit a server member's properties including nickname, roles, avatar, and timeout. Use this to assign roles, set nicknames, or timeout members.

edit_message

Edit Message

Edit an existing message in a Stoat channel. Can update the text content and embeds. Only messages authored by the authenticated user/bot can be edited.

create_channel

Create Channel

Create a new text or voice channel within a Stoat server, or create a group DM with specified users.

edit_role

Edit Role

Edit a role's properties in a Stoat server including name, colour, and hoist status. Legacy rank is accepted but ignored by current servers. Only fields provided will be updated.

fetch_invite

Fetch Invite

Fetch details about a Stoat invite by its code. Returns information about the server and channel the invite leads to.

create_role

Create Role

Create a new role in a Stoat server. Legacy rank is accepted but ignored by current servers.

edit_channel

Edit Channel

Edit a Stoat channel's settings. Can update name, description, NSFW status, and archive status. Only fields provided will be updated.

send_message

Send Message

Send a message to a Stoat channel. Supports text content, embeds, file attachments (by ID), replies, and masquerade (overriding displayed username/avatar). Can be used for both server channels and direct messages.

open_dm

Open Direct Message

Open a direct message channel with a user. Returns the DM channel ID which can then be used to send messages.

delete_server

Delete / Leave Server

Delete a server you own or leave a server you're a member of. If you are the owner, the server is permanently deleted. If you are a member, you leave the server.

execute_webhook

Execute Webhook

Send a message through a Stoat webhook. Messages can include text content, embeds, and a custom username/avatar. Does not require bot authentication.

fetch_user

Fetch User

Fetch a Stoat user's profile information including username, display name, status, badges, and profile content. Use "@me" as the user ID to fetch the authenticated user.

delete_emoji

Delete Emoji

Delete a custom emoji from a Stoat server.

delete_invite

Delete Invite

Delete a Stoat invite by its code. The invite will no longer be usable.

edit_server

Edit Server

Edit a Stoat server's settings including name, description, icon, banner, discoverability, and analytics. Only fields provided will be updated.

fetch_server_emoji

Fetch Server Emoji

List all custom emoji for a Stoat server. Returns emoji IDs, names, and metadata.

manage_ban

Ban / Unban Member

Ban or unban a user from a Stoat server. Banning prevents the user from rejoining. Can also list all bans for a server.

fetch_webhooks

Fetch Webhooks

List all webhooks for a Stoat channel. Returns webhook IDs, names, and tokens for execution.

fetch_channel

Fetch Channel

Fetch details about a Stoat channel including its type, name, description, and other properties.

search_messages

Search Messages

Search for messages in a Stoat channel using a full-text search query. Supports filtering by date range and sorting results.

create_invite

Create Invite

Create an invite link for a Stoat channel. The invite allows others to join the server or group.

kick_member

Kick Member

Kick a member from a Stoat server. The member can rejoin if they have an invite.

pin_message

Pin / Unpin Message

Pin or unpin a message in a Stoat channel. Pinned messages are highlighted and easily accessible for all channel members.

create_webhook

Create Webhook

Create a new webhook for a Stoat channel. Webhooks allow external systems to send messages to the channel without a bot account.

delete_role

Delete Role

Delete a role from a Stoat server. Members with this role will lose it.

fetch_server_invites

Fetch Server Invites

List all active invites for a Stoat server.

delete_channel

Delete / Leave Channel

Delete a server channel or leave a group DM / direct message channel.

fetch_members

Fetch Server Members

Fetch members of a Stoat server. Can fetch all members or a specific member by user ID.

fetch_role

Fetch Role

Fetch a server role, including its permission overrides and current rank.

set_permissions

Set Permissions

Set server or channel permissions for a role or all members. Replaces the selected permission values; requires permission management access.

list_dm_channels

List Direct Message Channels

List accessible direct message and group channels to discover channel IDs for reading or sending messages. Available to user sessions.

edit_webhook

Edit Webhook

Update an existing channel webhook name, avatar, or permissions.

delete_webhook

Delete Webhook

Permanently delete an existing channel webhook and revoke its execution token.

Connect Stoat to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Stoat in Metorial. In your Metorial portal, enable the Stoat MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Stoat tools.

Run Stoat through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Stoat and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Stoat tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Stoat

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Gmail

Send, read, and search email messages with support for recipients, attachments, and HTML content. Create, update, and send drafts. Manage conversation threads and organize messages with labels. Search mailboxes using Gmail query syntax (from, to, subject, date, attachment filters). Manage filters and vacation responders, update the primary address's display name and signature, and view send-as aliases, forwarding addresses, and auto-forwarding status. Import and insert messages for migration.

Google Drive

Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Read label definitions and search files by label. Browse the Drive apps installed for your account. Store app-specific data in a hidden per-user folder.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Technical notes for Stoat

Read, send, edit, delete, and search Stoat messages. Manage servers, channels, roles, permissions, members, bans, webhooks, emoji, and invite links. Discover direct message channels with user sessions.

Frequently asked questions

Common questions about connecting Stoat to AI agents with Metorial.

  1. How many tools does the Stoat MCP server have?
    The Stoat MCP server exposes 38 tools, including Fetch Server, Manage Reactions, Delete Messages. Each one is governed and traced through Metorial.
  2. Stoat exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Stoat MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Stoat and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Stoat MCP server yourself or use the hosted gateway.

Connect Stoat to production AI agents

See how Metorial gives your team governed access to Stoat, with tracing and security controls built in.