SnowLuma MCP Server: Setup for Claude, Cursor and Other Apps

• Lists the bot actions SnowLuma supports

  Returns a short index of every OneBot action in the catalog with name, category, summary and whether it is read-only. You can filter by category.

  Try: “List the group management actions.”

  Read · list_actions

• Shows the full docs for one action

  Returns one action's full documentation, its parameters and a ready-to-use JSON Schema. It accepts aliases.

  Try: “What parameters does set_group_ban take?”

  Read · get_action

• Searches actions by keyword

  Fuzzy search over action names, summaries and aliases.

  Try: “Find the action for sending a forward message.”

  Read · search_actions

• Lists action categories with counts

  Lists the categories of actions and how many each holds.

  Try: “What categories of actions are there?”

  Read · list_categories

• Shows the server's mode and limits

  Reports the current mode, whether execution is on, file limits and the catalog version. It only contacts SnowLuma if you ask it to check the connection.

  Try: “Is the MCP server in docs-only mode?”

  Read · get_runtime_info

• Calls a read-only action on a running SnowLuma

  Only available when you point the server at a running SnowLuma. Calls an action marked read-only, such as a get or can action, and returns the full OneBot response. It refuses actions that change things.

  Try: “Get the member list of group 123456.”

  Network · query_action

• Calls any action, including ones that send or change things

  Only available in write mode. Calls any known action, including sending messages and changing groups. For file uploads it can read a local file from a folder you set as the upload root.

  Try: “Send "hello" to group 123456.”

  Write · invoke_action

Watch out for

• Write mode lets the assistant act as your bot

  With SNOWLUMA_MCP_MODE=write the assistant can send messages and manage groups. Leave it off unless you need that, and have your client ask before each call. github.com

• Write mode can read and write local files

  File uploads read from a folder you set as the upload root, and downloads save to a directory on the MCP host that is not cleaned up automatically. github.com

Security advisories