{
  "info": {
    "name": "Revolt — mcp.ai",
    "description": "REST API for the Revolt MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/revolt",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "revolt_acknowledge_policy_changes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/acknowledge/policy/changes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "acknowledge",
            "policy",
            "changes"
          ]
        },
        "description": "Tool to acknowledge platform policy changes. Use when accepting or confirming policy updates for your bot account.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_add_channels_messages_reactions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/channels/messages/reactions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "channels",
            "messages",
            "reactions"
          ]
        },
        "description": "Tool to add a reaction to a message in a channel. Use when you want to react with an emoji to a specific message. Returns success on completion.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"msg\": \"\",\n  \"emoji\": \"\",\n  \"target\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_block_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/block/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "block",
            "user"
          ]
        },
        "description": "Tool to block another user by their ID. Use when you need to prevent interactions with a specific user.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"target\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_create_sync_settings_set",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/sync/settings/set",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "sync",
            "settings",
            "set"
          ]
        },
        "description": "Tool to upload and save settings data to Revolt's sync storage. Use when you need to persist user settings or preferences.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"settings\": {},\n  \"timestamp\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_delete_message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "message"
          ]
        },
        "description": "Tool to delete a message you've sent or one you have permission to delete. Use when you need to remove a message from a channel.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"channel_id\": \"\",\n  \"message_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_delete_messages_bulk",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/messages/bulk",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "messages",
            "bulk"
          ]
        },
        "description": "Tool to bulk delete multiple messages from a channel. Use when you need to delete multiple messages at once. Requires ManageMessages permission regardless of message ownership. Messages must have been",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"channel_id\": \"\",\n  \"message_ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_fetch_owned_bots",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/owned/bots",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "owned",
            "bots"
          ]
        },
        "description": "Tool to fetch all bots that you have control over. Use when you need to retrieve information about bots owned by the authenticated user account.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_fetch_sync_settings",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/sync/settings",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "sync",
            "settings"
          ]
        },
        "description": "Tool to fetch settings from server filtered by keys. Returns an object with the requested keys where each value is a tuple of (timestamp, value). Only settings that exist on the server will be include",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"keys\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_fetch_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "user"
          ]
        },
        "description": "Tool to fetch detailed information about a user. Use when you have a valid user ID and need full account details. Call after authenticating with bot token.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"user_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_fetch_user_flags",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/user/flags",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "user",
            "flags"
          ]
        },
        "description": "Tool to fetch flags associated with a specific user. Use after obtaining the user ID to inspect their special statuses or roles.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"user_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_get_api_info",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/api/info",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "api",
            "info"
          ]
        },
        "description": "Tool to fetch the server configuration for this Revolt instance. Use when you need to discover API version, feature availability, WebSocket endpoints, or service URLs.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_get_channel",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/channel",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "channel"
          ]
        },
        "description": "Tool to fetch a channel by its ID. Use when you need to retrieve detailed information about a specific channel.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"target\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_get_current_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/current/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "current",
            "user"
          ]
        },
        "description": "Tool to retrieve your own user information. Use when you need to fetch details about the authenticated user account.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_get_invite",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/invite",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "invite"
          ]
        },
        "description": "Tool to fetch detailed information about an invite by its code. Use when you have a valid invite code and need to retrieve invite details including server info, channel info, and member count.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"target\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_get_sync_unreads",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/sync/unreads",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "sync",
            "unreads"
          ]
        },
        "description": "Tool to fetch information about unread state on channels. Use when you need to check which channels have unread messages or mentions.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_get_user_profile",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/user/profile",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "user",
            "profile"
          ]
        },
        "description": "Tool to retrieve a user's profile data including bio and background. Use when you need profile-specific information beyond basic user data. Will fail if you do not have permission to access the target",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"target\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_get_users_default_avatar",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/users/default/avatar",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "users",
            "default",
            "avatar"
          ]
        },
        "description": "Tool to fetch a user's default avatar image based on their ID. Use when you need to retrieve the default avatar picture for a specific user.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"target\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_get_users_dm",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/users/dm",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "users",
            "dm"
          ]
        },
        "description": "Tool to open a DM with another user. Use when you need to start or access a direct message conversation. If the target is oneself, returns a saved messages channel.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"target\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_get_users_dms",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/users/dms",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "users",
            "dms"
          ]
        },
        "description": "Tool to fetch all direct message conversations for the authenticated user. Use when you need to list all DM and group DM channels.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_pin_message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/pin/message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "pin",
            "message"
          ]
        },
        "description": "Tool to pin a message in a channel by its ID. Use when you need to highlight important messages for channel members.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"msg\": \"\",\n  \"target\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_remove_message_reaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/remove/message/reaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "remove",
            "message",
            "reaction"
          ]
        },
        "description": "Tool to remove a reaction from a message. Use when you need to remove your own, someone else's, or all reactions of a given emoji from a message. Requires ManageMessages permission if removing others'",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"msg\": \"\",\n  \"emoji\": \"\",\n  \"target\": \"\",\n  \"user_id\": \"\",\n  \"remove_all\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_send_channels_messages",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/send/channels/messages",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "send",
            "channels",
            "messages"
          ]
        },
        "description": "Tool to send a message to a Revolt channel. Use when you need to post a text message, embed, or attachment to a specific channel. Call after authenticating with bot token.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"flags\": 0,\n  \"nonce\": \"\",\n  \"embeds\": \"\",\n  \"target\": \"\",\n  \"content\": \"\",\n  \"replies\": \"\",\n  \"masquerade\": {},\n  \"attachments\": \"\",\n  \"interactions\": {},\n  \"idempotency_key\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_unblock_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/unblock/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "unblock",
            "user"
          ]
        },
        "description": "Tool to unblock another user by their ID. Use when you need to remove a block on a specific user. The relationship status will change from 'Blocked' to 'None' after successful execution.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"target\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_unpin_message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/unpin/message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "unpin",
            "message"
          ]
        },
        "description": "Tool to unpin a message in a channel. Use when you need to remove a pinned message from the channel's pinned messages list.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"channel_id\": \"\",\n  \"message_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_update_channels_messages",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/channels/messages",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "channels",
            "messages"
          ]
        },
        "description": "Tool to edit a message that you've previously sent in a channel. Use when you need to update the content or embeds of an existing message. At least one of content or embeds must be provided.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"msg\": \"\",\n  \"embeds\": \"\",\n  \"target\": \"\",\n  \"content\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "revolt_update_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "user"
          ]
        },
        "description": "Tool to update user information. Use when you need to modify user profile or status fields. Call after authenticating with bot token.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"clear\": \"\",\n  \"avatar\": \"\",\n  \"user_id\": \"\",\n  \"status_text\": \"\",\n  \"profile_content\": \"\",\n  \"profile_background\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}