Skip to content
Back to search

mtslink-mcp

Local MCP server for the MTS Link macOS desktop app

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mukhanov--mtslink-mcp/badge.svg)](/listings/mukhanov--mtslink-mcp)

HTML

<a href="/listings/mukhanov--mtslink-mcp"><img src="/api/listings/mukhanov--mtslink-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires Node.js 22.5 or newer, macOS, and an installed MTS Link app. Open MTS Link and sign in before using authenticated tools. The app does not need any launch flags.

The package is not currently published to npm. Run it from a local checkout:

git clone https://github.com/mukhanov/mtslink-mcp.git
cd mtslink-mcp
npm install

MCP client configuration:

{
  "mcpServers": {
    "mtslink": {
      "command": "node",
      "args": ["/absolute/path/to/mtslink-mcp/src/server.js"]
    }
  }
}

Restart the MCP client after changing its configuration.

Environment variables:

- `MTSLINK_APP_PATH`: alternate `.app` path; default `/Applications/МТС Линк.app`. - `MTSLINK_PROFILE_PATH`: alternate app profile; default `~/Library/Application Support/LinkChats`. - `MTSLINK_GATEWAY_WS_URL`: alternate MTS Link gateway; default `wss://prod-ws-chat.mts-link.ru/v1`. Token-bearing connections are restricted to WSS on `mts-link.ru` and its subdomains. Plain WS is allowed only on loopback for local testing.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 105 lines
  1. # MTS Link MCP
  2. Local stdio MCP server for MTS Link on macOS. It uses the desktop app's existing session for direct HTTPS and WebSocket API calls. No remote debugging port, browser automation, or password input is required.
  3. Verified against MTS Link 0.91.0 (build 0.91.0.3140).
  4. ## Install and run
  5. Requires Node.js 22.5 or newer, macOS, and an installed MTS Link app. Open MTS Link and sign in before using authenticated tools. The app does not need any launch flags.
  6. The package is not currently published to npm. Run it from a local checkout:
  7. ```sh
  8. git clone https://github.com/mukhanov/mtslink-mcp.git
  9. cd mtslink-mcp
  10. npm install
  11. ```
  12. MCP client configuration:
  13. ```json
  14. {
  15. "mcpServers": {
  16. "mtslink": {
  17. "command": "node",
  18. "args": ["/absolute/path/to/mtslink-mcp/src/server.js"]
  19. }
  20. }
  21. }
  22. ```
  23. Restart the MCP client after changing its configuration.
  24. Environment variables:
  25. - `MTSLINK_APP_PATH`: alternate `.app` path; default `/Applications/МТС Линк.app`.
  26. - `MTSLINK_PROFILE_PATH`: alternate app profile; default `~/Library/Application Support/LinkChats`.
  27. - `MTSLINK_GATEWAY_WS_URL`: alternate MTS Link gateway; default `wss://prod-ws-chat.mts-link.ru/v1`. Token-bearing connections are restricted to WSS on `mts-link.ru` and its subdomains. Plain WS is allowed only on loopback for local testing.
  28. ## Tools
  29. | Tool | Purpose |
  30. |---|---|
  31. | `mtslink_app_info` | Installed version, bundle ID, workspace, and integration defaults |
  32. | `mtslink_open` | Open/focus the app or dispatch a meeting/chat/deep-link URL |
  33. | `mtslink_login` | Check the saved session and return basic current-account details |
  34. | `mtslink_api_request` | Authenticated JSON/text HTTPS request to MTS Link services |
  35. | `mtslink_list_chats` | List private and group chats with their chat IDs |
  36. | `mtslink_list_channels` | List channels with IDs accepted as `chatId` |
  37. | `mtslink_search_messages` | Search messages across the selected organization or within one chat |
  38. | `mtslink_get_messages` | Read messages from a private chat, group chat, channel, or thread |
  39. API example:
  40. ```json
  41. {
  42. "path": "/api/login",
  43. "base": "gateway",
  44. "method": "GET"
  45. }
  46. ```
  47. Supported bases are `gateway`, `webinar`, `page`, and `admin`. Absolute request URLs must use an MTS Link origin. HTTPS is required except for loopback development endpoints. Generic `POST`, `PUT`, `PATCH`, and `DELETE` requests can perform real account mutations.
  48. ## Session handling
  49. The server reads `gw_token` from a temporary copy of the app's Chromium `Session Storage` database. The token is used only in memory for the current request, is never included in tool results or logs, and the temporary database copy is deleted immediately afterward. At startup, the server also removes its own abandoned snapshot directories older than one hour; fresh snapshots belonging to active processes and unrelated files are left untouched.
  50. If the session is absent or expired, `mtslink_login` returns `authenticated: false`. Open MTS Link and sign in again to refresh it.
  51. ## Search messages
  52. Only `query` is required. The server uses the organization currently selected in MTS Link:
  53. ```json
  54. {
  55. "query": "SEARCH_TEXT",
  56. "size": 20
  57. }
  58. ```
  59. Use `chatId` to restrict results to one chat or channel. For the next page, pass `from` equal to the previous offset plus the number of requested results, for example `from: 20, size: 20`. The response includes `items`, `memberProfiles`, and `total`.
  60. ## Read chats and channels
  61. Use `mtslink_list_chats` or `mtslink_list_channels` to obtain an ID, then pass it as `chatId` to `mtslink_get_messages`:
  62. ```json
  63. {
  64. "chatId": "CHAT_OR_CHANNEL_ID",
  65. "limit": 50
  66. }
  67. ```
  68. For older messages, pass the first returned message ID as `from` with `direction: "Before"`. Use `direction: "After"` for newer messages and `orEqual: true` to include the boundary message. For thread replies, pass the parent message ID as `parentId`.
  69. These operations use the read-only RPC methods `Chat.GetMyDialogsAndGroupChatsV3`, `Chat.GetMyChannelsV3`, and `Chat.GetMessagesV2` over the MTS Link gateway WebSocket.
  70. ## Verification
  71. ```sh
  72. npm test
  73. ```
  74. Runtime smoke testing covers direct login, chat and channel lists, and message reading with the desktop app running normally without remote debugging.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.