OpenClaw MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OpenClaw MCP Server Get my RMappi balance"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 toolsRelated MCP server: Angular Bootstrap MCP Server
Install
npm installBuild
npm run buildRun
npm startThe server only supports stdio transport and is intended for local MCP clients that spawn the server process.
Deploy as a STDIO MCP Server
This server is deployed by installing dependencies, building the TypeScript output, and configuring an MCP client to spawn the built stdio entry point.
From the repository directory:
npm install
npm run buildUse node with the absolute path to dist/index.js as the MCP server command. Example client configuration:
{
"mcpServers": {
"openclaw": {
"command": "node",
"args": [
"C:\\Projects\\openclaw-mcp-tools\\dist\\index.js"
],
"env": {
"ENV_RMAPPI_USER": "email@example.com",
"ENV_RMAPPI_PASSWORD": "password"
}
}
}
}For a cloned checkout in a different location, replace the args path with that checkout's absolute dist/index.js path.
For macOS or Linux, the same configuration uses a POSIX path:
{
"mcpServers": {
"openclaw": {
"command": "node",
"args": [
"/absolute/path/to/openclaw-mcp-tools/dist/index.js"
],
"env": {
"ENV_RMAPPI_USER": "email@example.com",
"ENV_RMAPPI_PASSWORD": "password"
}
}
}
}If using the RMappi/Osuria tools on a fresh machine, also install the Chromium browser binary once:
npx playwright install chromiumAfter changing TypeScript files, run npm run build again before restarting the MCP client. The client owns the server process lifecycle; stop and restart the MCP client to pick up a new build or environment variable changes.
Inspect
Build first, then run the MCP Inspector against the stdio entry point:
npm run build
npm run inspectEquivalent direct command:
npx @modelcontextprotocol/inspector node dist/index.jsUse 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 chromiumRMappi/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.
Available Tools
3 toolsopenclaw_get_rmappi_balanceGet RMappi BalanceARead-only
Use this tool when the user asks for RMappi/Osuria saldo, bank balance, available funds, or taloyhtion tilin saldo. It logs in to https://app.osuria.com with environment credentials, reads the Balance page account cards, logs out, and closes the browser session. Credentials are read only from ENV_RMAPPI_USER and ENV_RMAPPI_PASSWORD, with temporary fallback ENV_RMAPPI__PASSWORD.
Inputs: no named parameters. Returns: accounts
openclaw_get_rmappi_invoicesGet RMappi InvoicesARead-only
Use this tool when the user asks for RMappi/Osuria invoices, laskut, voucher numbers, invoice totals, or invoices for a specific month. It logs in to https://app.osuria.com with environment credentials, reads x-session-token from sessionStorage after login, calls the RMappi invoices API for the requested year and month, logs out, and closes the browser session. The access token is used only inside the automation and is never returned.
Inputs: year, month. Returns: invoices
openclaw_server_infoOpenClaw Server InfoARead-onlyIdempotent
Returns basic information about the OpenClaw MCP server and the registered toolsets. This tool is read-only and does not call external services.
Inputs: response_format. Returns: name, version, toolsets
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct purpose: balance retrieval, invoice retrieval, and server info. The two RMappi tools are clearly differentiated by their function (balance vs invoices), and the third is entirely separate. No ambiguity.
All tools follow a consistent naming pattern: 'openclaw_' + verb_noun (get_rmappi_balance, get_rmappi_invoices, server_info). The pattern is uniform and predictable.
With only 3 tools, the server feels minimal. While it covers balance and invoices for RMappi, the scope is narrow. The count is acceptable for a focused utility but could be expanded.
The domain appears to be RMappi/Osuria financial operations, but only balance and invoices are covered. Missing common operations like listing accounts, transaction history, or payments leaves significant gaps.
Maintenance
Related MCP Connectors
A simple Typescript MCP server built using the official MCP Typescript SDK and smithery/cli. This…
timesheet.io MCP server - manage timers, projects, tasks and reports
The official MCP Server for the Mux API
Related MCP Servers
- AlicenseAqualityDmaintenanceA TypeScript-based MCP server that enables testing of REST APIs through Cline. This tool allows you to test and interact with any REST API endpoints directly from your development environment.1149 npm104MIT
- AlicenseNot gradedqualityDmaintenanceA TypeScript-based MCP server that provides backend API handling and facilitates communication between microservices. Features an organized structure with controllers, routes, and models for easy extensibility and maintenance.1ISC
- AlicenseNot gradedqualityDmaintenanceA demonstration MCP server built in TypeScript that shows how to implement stdio-based communication for integration with MCP clients. Serves as a template for building custom MCP servers with strong typing and maintainability.ISC
- AlicenseCqualityDmaintenanceA modular MCP server that connects to external APIs, providing tools for weather data, user management, and company operations. Features a scalable architecture with TypeScript support, HTTP client abstraction, and robust error handling.5ISC