OpenClaw MCP Server

General TypeScript MCP server for OpenClaw tools.

The server is organized around toolsets so new OpenClaw capabilities can be added without recreating MCP startup, transport, and registration boilerplate.

Structure

src/
  index.ts              # transport startup
  server.ts             # MCP server factory
  toolsets/
    index.ts            # registers all toolsets
    toolset.ts          # shared toolset interface
    core.ts             # base server introspection tools

Related MCP server: Angular Bootstrap MCP Server

Install

npm install

Build

npm run build

Run

npm start

The server only supports stdio transport and is intended for local MCP clients that spawn the server process.

Inspect

Build first, then run the MCP Inspector against the stdio entry point:

npm run build
npm run inspect

Equivalent direct command:

npx @modelcontextprotocol/inspector node dist/index.js

Use dist/index.js, not dist/server.js. The server.js file only exports the MCP server factory and does not connect a stdio transport.

Adding Toolsets

Create a new file in src/toolsets/:

import type { Toolset } from "./toolset.js";

export const myToolset: Toolset = {
  name: "my-toolset",
  description: "Tools for a focused OpenClaw capability.",
  register(server) {
    server.registerTool(
      "openclaw_my_action",
      {
        title: "My Action",
        description: "Does one focused OpenClaw action.",
        inputSchema: {},
        annotations: {
          readOnlyHint: true,
          destructiveHint: false,
          idempotentHint: true,
          openWorldHint: false
        }
      },
      async () => ({
        content: [{ type: "text", text: "ok" }]
      })
    );
  }
};

Then add it to src/toolsets/index.ts.

Tool names should use the openclaw_ prefix and snake_case verbs, for example openclaw_list_projects or openclaw_create_job.

RMappi/Osuria Balance Tool

Tool: openclaw_get_rmappi_balance

Use this tool when the user asks for RMappi/Osuria saldo, bank balance, available funds, or taloyhtion tilin saldo.

Required environment variables:

$env:ENV_RMAPPI_USER = "email@example.com"
$env:ENV_RMAPPI_PASSWORD = "password"

Temporary compatibility fallback:

$env:ENV_RMAPPI__PASSWORD = "password"

The tool does not accept credentials as MCP arguments. It opens https://app.osuria.com, accepts the cookie dialog if present, logs in, navigates to /balance, reads account cards by visible labels, logs out, and closes the browser.

If Playwright browser binaries are not installed yet, run:

npx playwright install chromium

RMappi/Osuria Invoices Tool

Tool: openclaw_get_rmappi_invoices

Use this tool when the user asks for RMappi/Osuria invoices, laskut, voucher numbers, invoice totals, or invoices for a specific month.

Inputs:

{
  "year": 2026,
  "month": 6
}

Both fields are optional. If omitted, the tool uses the current local year and month.

The tool uses the same ENV_RMAPPI_USER and ENV_RMAPPI_PASSWORD credentials as the balance tool. After login it reads sessionStorage["x-session-token"], calls the RMappi invoices API with that token, returns the API JSON array, logs out, and closes the browser. The token is never returned in tool output.