fetch_server
Fetch Server
Fetch details about a Stoat server including its name, description, channels, roles, and settings.
Ask your agent in plain language. Each of these maps to a real tool on the server.
fetch_server
Fetch details about a Stoat server including its name, description, channels, roles, and settings.
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 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 a new Stoat server with a name and optional description.
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 a server member's properties including nickname, roles, avatar, and timeout. Use this to assign roles, set nicknames, or timeout members.
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 a new text or voice channel within a Stoat server, or create a group DM with specified users.
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 details about a Stoat invite by its code. Returns information about the server and channel the invite leads to.
create_role
Create a new role in a Stoat server. Legacy rank is accepted but ignored by current servers.
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 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 a direct message channel with a user. Returns the DM channel ID which can then be used to send messages.
delete_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
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 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 a custom emoji from a Stoat server.
delete_invite
Delete a Stoat invite by its code. The invite will no longer be usable.
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
List all custom emoji for a Stoat server. Returns emoji IDs, names, and metadata.
manage_ban
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
List all webhooks for a Stoat channel. Returns webhook IDs, names, and tokens for execution.
fetch_channel
Fetch details about a Stoat channel including its type, name, description, and other properties.
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 an invite link for a Stoat channel. The invite allows others to join the server or group.
kick_member
Kick a member from a Stoat server. The member can rejoin if they have an invite.
pin_message
Pin or unpin a message in a Stoat channel. Pinned messages are highlighted and easily accessible for all channel members.
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 a role from a Stoat server. Members with this role will lose it.
fetch_server_invites
List all active invites for a Stoat server.
delete_channel
Delete a server channel or leave a group DM / direct message channel.
fetch_members
Fetch members of a Stoat server. Can fetch all members or a specific member by user ID.
fetch_role
Fetch a server role, including its permission overrides and current rank.
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 accessible direct message and group channels to discover channel IDs for reading or sending messages. Available to user sessions.
edit_webhook
Update an existing channel webhook name, avatar, or permissions.
delete_webhook
Permanently delete an existing channel webhook and revoke its execution token.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
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.
Common questions about connecting Stoat to AI agents with Metorial.