KosmoKrator

communication

Matrix MCP Integration for Cursor

Connect Matrix to Cursor through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 5 read 2 write Bearer token auth
Submit Matrix feedback View package source

Connect Matrix to Cursor

Expose selected local integrations to Cursor through KosmoKrator without configuring each service as its own MCP server.

Create or update .cursor/mcp.json with a KosmoKrator stdio server entry. The gateway is local, scoped to this integration, and starts with --write=deny so Cursor can inspect read-capable tools without receiving write access by default.

Matrix MCP Config for Cursor

Use the same KosmoKrator install and integration credentials that power terminal and headless runs.

{
  "mcpServers": {
    "kosmokrator-matrix": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=matrix",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=matrix --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Matrix instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Matrix Tools Visible to Cursor

Cursor sees stable MCP tool names generated from the Matrix integration catalog.

MCP toolSource functionTypeDescription
integration__matrix__matrix_list_rooms matrix.matrix_list_rooms Read List rooms the authenticated user has joined on Matrix. Returns room IDs, names, and aliases.
integration__matrix__matrix_get_room matrix.matrix_get_room Read Get details of a specific Matrix room, including name, topic, members, and aliases.
integration__matrix__matrix_create_room matrix.matrix_create_room Write Create a new room on the Matrix homeserver. Returns the newly created room ID.
integration__matrix__matrix_send_message matrix.matrix_send_message Write Send a text message to a Matrix room. Uses a unique transaction ID to prevent duplicate messages.
integration__matrix__matrix_list_members matrix.matrix_list_members Read List members of a Matrix room. Returns user IDs, display names, and avatar URLs.
integration__matrix__matrix_get_profile matrix.matrix_get_profile Read Get a Matrix user's profile information, including display name and avatar URL.
integration__matrix__matrix_get_current_user matrix.matrix_get_current_user Read Get the currently authenticated Matrix user's information, including user ID and device ID.

Related Matrix Pages

Matrix CLIUse direct JSON commands instead of MCP discovery. Matrix MCPFull gateway reference and MCP tool names. KosmoKrator for CursorClient-level gateway setup.