{
 "kind": "mcp",
 "slug": "io-walkeros-flow",
 "path": "mcp/servers/io-walkeros-flow/",
 "name": "walkerOS Flow",
 "maker": "elbwalker",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Cloud and DevOps",
   "mcp/cloud/"
  ]
 ],
 "lead": "build and test tracking setups with AI.",
 "chips": [
  {
   "label": "Cloud and DevOps",
   "path": "mcp/cloud/"
  },
  {
   "label": "Official"
  },
  {
   "label": "Local"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add --transport http walkeros https://app.walkeros.io/api/mcp"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/elbwalker/walkerOS"
  },
  {
   "label": "Website",
   "href": "https://www.walkeros.io/docs/apps/mcp"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "The service itself",
   "status": "yes",
   "sub": "Official server",
   "quote": "\"name\": \"io.walkeros/flow\",",
   "note": "Published by elbwalker, the company that makes walkerOS, from its own GitHub organization; the registry name io.walkeros and the hosted address app.walkeros.io match walkeros.io.",
   "src": "https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/packages/mcps/mcp/server.json"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "No key needed",
   "status": "yes",
   "sub": "No account",
   "quote": "@walkeros/mcp and @walkeros/mcp-source-browser need no environment variables, and the hosted server needs none either: it signs you in with OAuth.",
   "note": "The local server needs no environment variables and no account. The hosted server signs you in with OAuth in the browser; a script or CI job uses an automation token (wos_pat_...) as a Bearer header instead.",
   "src": "https://www.walkeros.io/docs/apps/mcp"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "On your machine",
   "status": "cond",
   "sub": "Runs code locally: npm",
   "note": "Checked: yes.",
   "src": "https://github.com/elbwalker/walkerOS"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "Allowed",
   "status": "yes",
   "sub": "MIT license",
   "quote": "Permission is hereby granted, free of charge, to any person obtaining a copy",
   "note": "MIT license, free of charge for any use.",
   "src": "https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/LICENSE"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What walkerOS Flow does",
   "parts": [
    {
     "t": "prose",
     "text": "walkerOS is an open source way to collect site and app events, such as page views and purchases. It sends them to tools like GA4, ad platforms or a data warehouse. This server lets your AI assistant create that setup, check it, try events on it without sending anything, and bundle it for your site. A hosted version also works on flows saved in the walkerOS app."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Set up GA4 tracking by asking",
       "text": "Ask for a web setup that sends events to GA4, and the assistant creates it, checks it and tries a page view, all on your computer with no account.",
       "idea": false
      },
      {
       "title": "Try an event before it goes live",
       "text": "Send a test page view through your setup file and see which tools would receive it, without calling any of them.",
       "idea": false
      },
      {
       "title": "Map events to a destination's fields",
       "text": "Let the assistant write the rules that turn your events into the shape a tool such as gtag expects, using the package's own examples.",
       "idea": false
      },
      {
       "title": "Learn what a destination needs",
       "text": "Ask what settings a destination, for example Snowplow, needs, and get its options, hints and examples before you write anything.",
       "idea": false
      },
      {
       "title": "Bundle the setup for your site",
       "text": "Turn the checked setup into one small script file for your site or server, with only the parts it uses.",
       "idea": false
      },
      {
       "title": "Deploy a saved flow",
       "text": "With a walkerOS account and the hosted server, ask the assistant to deploy your checkout flow and report when it is live.",
       "idea": false
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "walkerOS Flow popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "351",
       "l": "GitHub stars, elbwalker/walkerOS"
      },
      {
       "n": "412",
       "l": "downloads last week, @walkeros/mcp"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (8)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "flow_load",
       "text": "Loads a flow from text, a file or a web address, or creates a new empty web or server flow."
      },
      {
       "name": "flow_validate",
       "text": "Checks events, flows, mapping rules or data contracts and returns errors and warnings with stable codes."
      },
      {
       "name": "flow_examples",
       "text": "Lists the step examples in a flow, usable as test data."
      },
      {
       "name": "package_search",
       "text": "Browses the walkerOS package catalog or looks up one package by exact name."
      },
      {
       "name": "package_get",
       "text": "Returns a package's settings schemas, hints and examples."
      },
      {
       "name": "flow_bundle",
       "text": "Builds a flow into a production JavaScript bundle and writes it to a file."
      },
      {
       "name": "flow_simulate",
       "text": "Runs an event through one step of a flow without real calls and returns per-destination results."
      },
      {
       "name": "flow_push",
       "text": "Pushes a real event through a flow to the real destinations."
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "real events with their data",
       "sub": "To the destinations in your flow (for example GA4 or ad platforms); only when flow_push runs. Opt out: use flow_simulate instead."
      },
      {
       "l": "Sends",
       "v": "package names and versions looked up",
       "sub": "To the npm registry and jsDelivr; on package_search, package_get, and flow_validate when it checks package settings. Opt out: pass offline true to flow_validate."
      },
      {
       "l": "Sends",
       "v": "anonymous usage events (tool name, outcome, duration, client name, OS, Node.js version)",
       "sub": "To app.walkeros.io/api/telemetry (elbwalker GmbH); only after you opt in with walkeros telemetry enable. Opt out: off by default; DO_NOT_TRACK=1 or WALKEROS_TELEMETRY_DISABLED=1 force it off."
      },
      {
       "l": "Sends",
       "v": "everything the hosted tools read and change in your walkerOS projects",
       "sub": "To app.walkeros.io; when you use the hosted server. Opt out: use only the local server."
      }
     ]
    },
    {
     "t": "prose",
     "text": "Free and open source under the MIT license, also for paid products. The hosted server needs a walkerOS account."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "Yes",
       "status": "yes",
       "sub": "MIT license, free of charge for any use.",
       "quote": "Permission is hereby granted, free of charge, to any person obtaining a copy",
       "src": "https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/LICENSE"
      },
      {
       "l": "Pass on its files",
       "v": "With conditions",
       "status": "cond",
       "sub": "Allowed when the copyright and permission notice are kept.",
       "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
       "src": "https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/LICENSE"
      },
      {
       "l": "client-work",
       "v": "Yes",
       "status": "yes",
       "sub": "MIT allows use in client projects; the hosted server acts with the signed-in person's rights.",
       "quote": "MIT licensed - self-host anywhere, no vendor lock-in",
       "src": "https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/README.md"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "4.5.0 in the registry, updated Sep 2, 2026"
      },
      {
       "l": "Last release",
       "v": "@walkeros/mcp 4.9.0 on npm, published 2026-11-04 (the registry entry still lists 4.5.0)"
      },
      {
       "l": "Remote endpoint",
       "v": "yes",
       "status": "yes"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "walkerOS Flow",
       "me": true,
       "facts": [
        "351 stars",
        "Local"
       ]
      },
      {
       "name": "posthog",
       "why": "Pick it if you want one hosted analytics product with session replay and feature flags",
       "path": null,
       "facts": [
        "Local"
       ]
      },
      {
       "name": "segment-analytics-node",
       "why": "Pick it if your events already go to Segment",
       "path": null,
       "facts": [
        "Local"
       ]
      },
      {
       "name": "Other servers from the same repository",
       "why": "walkerOS Source Browser",
       "facts": []
      }
     ],
     "more": "All cloud and devops servers",
     "more_path": "mcp/cloud/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Add the walkerOS flow MCP server (npx @walkeros/mcp@4.9.0), create a web flow with a GA4 destination in ./flow.json, run flow_validate and flow_simulate on a page view, and do not call flow_push without asking me."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add --transport http walkeros https://app.walkeros.io/api/mcp"
      },
      {
       "tab": "npm (stdio)",
       "code": "npx -y @walkeros/mcp"
      },
      {
       "tab": "Cursor",
       "code": "{\n  \"mcpServers\": {\n    \"walkeros-flow\": {\n      \"command\": \"npx\",\n      \"args\": [\"@walkeros/mcp\"]\n    },\n    \"walkeros\": {\n      \"type\": \"http\",\n      \"url\": \"https://app.walkeros.io/api/mcp\"\n    }\n  }\n}\n"
      }
     ]
    },
    {
     "t": "small",
     "text": "The local server needs no environment variables and no account. The hosted server signs you in with OAuth in the browser; a script or CI job uses an automation token (wos_pat_...) as a Bearer header instead."
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Calling flow_push to test a new setup",
       "fix": "Use flow_simulate first; call flow_push only on purpose, and preferably for server flows.",
       "why": "flow_push makes real calls to real destinations, and web destinations need browser globals Node.js lacks."
      },
      {
       "dont": "Passing inline flow text as configPath to flow_bundle",
       "fix": "Pass a file path or a web address.",
       "why": "flow_bundle reads the value as a file name and fails."
      },
      {
       "dont": "Writing a config loaded with flow_load straight back to disk",
       "fix": "Remove the user_data wrapper from each string value first.",
       "why": "Values people wrote come back wrapped, and the wrapper would become part of the value."
      },
      {
       "dont": "Guessing a package name for package_get",
       "fix": "Call package_search first and use the exact name it returns.",
       "why": "package_get needs the exact package name."
      },
      {
       "dont": "Validating the structured output of every tool with the MCP TypeScript SDK client",
       "fix": "Read the text block or skip output-schema validation for flow_load, flow_examples, flow_bundle and flow_simulate.",
       "why": "Their advertised output schemas leave out fields the results carry, so a validating client rejects the results."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Do I need a walkerOS account?",
       "a": "Not for the local server. Creating, checking, simulating and bundling flows runs on your computer with no account; deploying saved flows needs the hosted server and an account.",
       "evidence": {
        "url": "https://www.walkeros.io/docs/apps/mcp",
        "quote": "The local loop (create, validate, simulate) needs neither."
       }
      },
      {
       "q": "Does simulating send data to Google or other tools?",
       "a": "No. flow_simulate makes no real calls; only flow_push does.",
       "evidence": {
        "url": "https://www.walkeros.io/docs/apps/mcp",
        "quote": "This makes real API calls."
       }
      },
      {
       "q": "Does the server send usage data to walkerOS?",
       "a": "Only if you opted in with walkeros telemetry enable. It then sends tool names, outcomes and timings, never file contents or flow settings.",
       "evidence": {
        "url": "https://www.walkeros.io/docs/apps/telemetry",
        "quote": "If you have never opted in on the machine, those surfaces stay silent."
       }
      },
      {
       "q": "Can a saved flow in the walkerOS app be tested locally?",
       "a": "Yes. The hosted server gives a config link that lasts about ten minutes, and the local tools read the config from it.",
       "evidence": {
        "url": "https://www.walkeros.io/docs/apps/mcp",
        "quote": "The link lasts about ten minutes."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "io.walkeros/flow"
  ],
  [
   "Category",
   "Cloud and DevOps"
  ],
  [
   "Version",
   "4.5.0"
  ],
  [
   "Package",
   "npm @walkeros/mcp"
  ],
  [
   "License",
   "MIT"
  ],
  [
   "GitHub",
   "elbwalker/walkerOS"
  ],
  [
   "In the registry since",
   "Sep 2, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "flow_push sends real events to the real destinations, such as your analytics or ad accounts. Use flow_simulate to try things.",
  "The local server reads files and web addresses on your computer and writes bundles to disk. The hosted server cannot see your files.",
  "A client connected to the hosted server acts as you. It can change, deploy and delete flows and manage secrets in every project you belong to."
 ],
 "checked_line": "Read by AgentGid from 17 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/elbwalker.png"
}