KosmoKrator

communication

Matrix MCP Integration for LangChain

Connect Matrix to LangChain 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 LangChain

Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls.

Use the MCP gateway when the agent should discover tools, or wrap kosmo integrations:call for fixed chains. The gateway is local, scoped to this integration, and starts with --write=deny so LangChain can inspect read-capable tools without receiving write access by default.

Matrix MCP Config for LangChain

Keep the gateway scoped to the integration and operation class needed by the chain.

{
  "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 LangChain

LangChain 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 LangChainClient-level gateway setup.