# walkerOS Source Browser — MCP server card for AI agents

Generate, parse, and validate walkerOS data-elb HTML tagging attributes

Registry name: `io.walkeros/source-browser` · category: Browser and web scraping · version 4.5.0 · updated 2026-09-02

## Connect
- npm (stdio): `npx -y @walkeros/mcp-source-browser`

## Facts
- Repository: https://github.com/elbwalker/walkerOS (351 stars)
- Website: https://www.walkeros.io/docs/apps/mcp

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/io-walkeros-source-browser/


## walkerOS Source Browser: tracking tags written and checked

walkerOS is an open source tool that tracks clicks and views on your site from small tags in the page markup, without extra code. This server lets your AI assistant write those tags, read back which events a piece of markup sends, and check it for common mistakes. It runs on your computer and needs no account.

### Where to use it
- Tag a product card for tracking: Describe the card, for example a product with a name and price, and the assistant returns ready-to-paste tags for it.
- Track a promotion banner: Ask for tags on a sale banner with its name and a click action, and paste them into the banner's markup.
- See what a page section will send: Paste a block of your page, and the assistant lists the events and shared properties it will produce, before anything goes live.
- Catch tagging mistakes: Before a release, let the assistant check your tagged markup for empty names, actions with no item, unknown triggers and similar slips.
- Tag a whole component library once: Have the assistant add tags to each shared component, such as cards and buttons, so every page that uses them is tracked. (idea, not from the official pages)

### How to start
- Add the server to your assistant's configuration. It starts on your computer when the assistant needs it.

```
{
  "mcpServers": {
    "walkeros-source-browser": {
      "command": "npx",
      "args": ["@walkeros/mcp-source-browser"]
    }
  }
}
```

- Ask it to tag an element, then to validate the result before you paste it into your page.

### License
Free and open source under the MIT license, also for paid products. Keep the license notice when you pass the code on.

### Good to know
- All three tools only read the text you give them. They change no files and make no web requests.
- The tags only produce events once the walkerOS browser source runs on your page; this server writes and checks them, it does not track anything.
- An element can carry only one link to another element; asking for more than one is refused.

Checked 2026-11-10 against: https://www.walkeros.io/docs/apps/mcp, https://www.walkeros.io/docs/sources/web/browser/tagging/html-attributes, https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/LICENSE, https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/packages/mcps/source-browser/README.md, https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/packages/mcps/source-browser/package.json, https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/packages/mcps/source-browser/server.json, https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/packages/mcps/source-browser/src/index.ts, https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/packages/mcps/source-browser/src/tools/generate.ts, https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/packages/mcps/source-browser/src/tools/parse.ts, https://github.com/elbwalker/walkerOS/blob/dedbdf71653b227f3f61e4c615a6aa4530b89dda/packages/mcps/source-browser/src/tools/validate.ts, https://registry.npmjs.org/@walkeros/mcp-source-browser/4.9.0, https://registry.npmjs.org/@walkeros/mcp-source-browser/-/mcp-source-browser-4.9.0.tgz

### Mistakes to avoid
- Don't: Installing the walkerOS Claude Code plugin and expecting the tagging tools → Do: Add walkeros-source-browser to the MCP configuration separately. (The plugin registers only the flow servers and skills.)
- Don't: Calling generate_tagging with only a prefix → Do: Pass at least an entity, data, action or another field besides prefix. (The tool needs something to generate.)
- Don't: Passing two entries in link, such as {"details": "parent", "more": "child"} → Do: Give each element exactly one link, as {"details": "parent"}. (An element carries one link.)
- Don't: Using parse_tagging to find tagging errors → Do: Use validate_tagging for issue detection; parse_tagging only extracts events. (The two tools have different jobs.)

### Questions
- Do I need a walkerOS account? No. The server runs on your computer and needs no account or token.
- Does the walkerOS Claude Code plugin include it? No. The plugin adds the flow servers and skills, not this one, so add it to the configuration yourself.
- My site uses a different attribute name. Does it still work? Yes. All three tools take an optional prefix; the default is data-elb.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
