About walkerOS Flow
walkerOS Flow is a local MCP server for validating, simulating, bundling, and pushing walkerOS event flows on a machine. It is aimed at people building or operating walkerOS pipelines; a hosted server covers data stored in the walkerOS app.
Key features
- 01Validate event flows
- 02Simulate flows
- 03Bundle flows
- 04Push flows
Use cases
- 01Validate walkerOS flows locally
- 02Simulate flow behavior
- 03Bundle and push event pipelines
MCP support
The local server runs over stdio and is launched by an MCP client. A hosted endpoint covers content stored in the walkerOS app.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @walkeros/mcpWALKEROS_TOKENSecretwalkerOS API token. Optional, the local tools work without it and the auth tool can log in instead.WALKEROS_PROJECT_IDDefault walkerOS project id (proj_...) used by the cloud tools.WALKEROS_APP_URLBase URL override for the walkerOS app. Defaults to https://app.walkeros.io.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
17Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | enum | Yes | Authentication action to performstatus | login | logout |
| deviceCode | string | No | Device code from a previous pending login attempt. Provide to resume polling without requesting a new code. |
Details
From the project README@walkeros/mcp
The local walkerOS MCP server: validate, simulate, bundle and push flows on your own machine; the hosted server at https://app.walkeros.io/api/mcp covers what the walkerOS app stores.
Documentation • NPM Package • Source Code
Installation
npm install @walkeros/mcp
Quick start
The server runs over stdio and is started by your MCP client. Add it to the client's configuration:
{
"mcpServers": {
"walkeros-flow": {
"command": "npx",
"args": ["@walkeros/mcp"]
}
}
}
Documentation
Tools, resources, prompts, programmatic usage and the hosted server live in the docs: https://www.walkeros.io/docs/apps/mcp
Contribute
Feel free to contribute by submitting an issue, starting a discussion, or getting in contact.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.