{"_id":"@agentutility/mcp-browser-workflow","_rev":"3-67b2fd22640ddd6546ade2d7ff2f24bf","name":"@agentutility/mcp-browser-workflow","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@agentutility/mcp-browser-workflow","version":"0.1.0","keywords":["mcp","model-context-protocol","x402","agentutility","agent-tools","browser-workflow"],"license":"MIT","_id":"@agentutility/mcp-browser-workflow@0.1.0","maintainers":[{"name":"agentutility","email":"aroozen+agentutility@gmail.com"}],"homepage":"https://mcp.agentutility.ai/browser-workflow/","bugs":{"url":"https://github.com/rooz21/x402/issues"},"bin":{"agentutility-mcp-browser-workflow":"dist/index.js"},"dist":{"shasum":"24fde54a8d900d27703621ea7cf00d36f339eee0","tarball":"https://registry.npmjs.org/@agentutility/mcp-browser-workflow/-/mcp-browser-workflow-0.1.0.tgz","fileCount":4,"integrity":"sha512-bzspeIesZsgCuqwCDtSiHhOZJjLDVtu0r08hJO+gvhalqUv1Klu4zy+qRIdODiUqLrfc91ToV+bfnTH5On9q4w==","signatures":[{"sig":"MEUCIQCUfxm+mG6d6bCcVJ2ZwgEhwSys/ThoYSZlGYXFGv1qrgIgW17JbTA0zRwGuVZ2x/zMVxdPduVO/Hi02iA1BD9Dtbc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14935},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"8e3370cd73fe23e3f870b4bc9ce1c3f33a1ce816","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"agentutility","email":"aroozen+agentutility@gmail.com"},"repository":{"url":"git+https://github.com/rooz21/x402.git","type":"git","directory":"packages/mcp-browser-workflow"},"_npmVersion":"10.8.2","description":"MCP server for the @agentutility browser-workflow cluster — pay-per-call x402 tools, no API keys, USDC on Base.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"viem":"^2.21.0","@x402/evm":"^2.12.0","@x402/fetch":"^2.12.0","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-browser-workflow_0.1.0_1783307533393_0.12988169029197172","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agentutility/mcp-browser-workflow","version":"0.1.1","keywords":["mcp","model-context-protocol","x402","agentutility","agent-tools","browser-workflow"],"license":"MIT","_id":"@agentutility/mcp-browser-workflow@0.1.1","maintainers":[{"name":"agentutility","email":"aroozen+agentutility@gmail.com"}],"homepage":"https://mcp.agentutility.ai/browser-workflow/","bugs":{"url":"https://github.com/rooz21/x402/issues"},"bin":{"agentutility-mcp-browser-workflow":"dist/index.js"},"dist":{"shasum":"6043c461fb9cc05879c39d63db07e0b0f58c1d9c","tarball":"https://registry.npmjs.org/@agentutility/mcp-browser-workflow/-/mcp-browser-workflow-0.1.1.tgz","fileCount":4,"integrity":"sha512-Bc6PooGzSYivgxTjO9Z/aHiGiR4BYzd9YR2xwn71ewezHIQfZRM6zWvW9BN0wUlvMC35NDi0l2TTa1AozrVOZQ==","signatures":[{"sig":"MEUCIQDi7BRCIw2Yejm6SRmCu3lOfKLd8JXjKlUqmGv1kP8/4wIgLa39f65s/lRtyBqE+O5reaLeoFK8aTkJBEzS1M2ryeY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14988},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"bb16253ab9d06c11e824e1f2d1d907a5c815ef11","mcpName":"ai.agentutility/mcp-browser-workflow","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"agentutility","email":"aroozen+agentutility@gmail.com"},"repository":{"url":"git+https://github.com/rooz21/x402.git","type":"git","directory":"packages/mcp-browser-workflow"},"_npmVersion":"10.8.2","description":"MCP server for the @agentutility browser-workflow cluster — pay-per-call x402 tools, no API keys, USDC on Base.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"viem":"^2.21.0","@x402/evm":"^2.12.0","@x402/fetch":"^2.12.0","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-browser-workflow_0.1.1_1783646505174_0.9608691481847291","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@agentutility/mcp-browser-workflow","mcpName":"ai.agentutility/mcp-browser-workflow","version":"0.1.3","description":"MCP server for the @agentutility browser-workflow cluster — pay-per-call x402 tools, no API keys, USDC on Base.","license":"MIT","type":"module","main":"dist/index.js","bin":{"agentutility-mcp-browser-workflow":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/rooz21/x402.git","directory":"packages/mcp-browser-workflow"},"homepage":"https://mcp.agentutility.ai/browser-workflow/","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","x402","agentutility","agent-tools","browser-workflow"],"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","@x402/fetch":"^2.12.0","@x402/evm":"^2.12.0","viem":"^2.21.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.5.0"},"engines":{"node":">=18"},"_id":"@agentutility/mcp-browser-workflow@0.1.3","bugs":{"url":"https://github.com/rooz21/x402/issues"},"_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-xcS3YaghyjR3ChnArmieVBJpbYDKI25T/xIJZTYW6Pe0mQD25aQbrDj0qIFdsd6npKHMps2cCCWZB/BeLW2OAQ==","shasum":"a765d97a7f171bb423e7cabe9e849138a4fce215","tarball":"https://registry.npmjs.org/@agentutility/mcp-browser-workflow/-/mcp-browser-workflow-0.1.3.tgz","fileCount":4,"unpackedSize":14988,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCiA2iM9M+HiNemIqgyvcfqXCwxB/hkeDIrHPnk57gA9AIgUnkdcg+O1ZJSKM2VzlBOowZTSjO7tEg4gWBLyUQCmrE="}]},"_npmUser":{"name":"agentutility","email":"aroozen+agentutility@gmail.com"},"directories":{},"maintainers":[{"name":"agentutility","email":"aroozen+agentutility@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-browser-workflow_0.1.3_1784663272641_0.7403320328395802"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-06T03:12:13.217Z","modified":"2026-07-21T19:47:52.905Z","0.1.0":"2026-07-06T03:12:13.552Z","0.1.1":"2026-07-10T01:21:45.311Z","0.1.3":"2026-07-21T19:47:52.777Z"},"bugs":{"url":"https://github.com/rooz21/x402/issues"},"license":"MIT","homepage":"https://mcp.agentutility.ai/browser-workflow/","keywords":["mcp","model-context-protocol","x402","agentutility","agent-tools","browser-workflow"],"repository":{"type":"git","url":"git+https://github.com/rooz21/x402.git","directory":"packages/mcp-browser-workflow"},"description":"MCP server for the @agentutility browser-workflow cluster — pay-per-call x402 tools, no API keys, USDC on Base.","maintainers":[{"name":"agentutility","email":"aroozen+agentutility@gmail.com"}],"readme":"# @agentutility/mcp-browser-workflow\n\n> Workflow memory for brittle browser and desktop agents.\n\nFrontier probe for turning screenshots, Playwright traces, DOM snapshots, and recorded task paths into reusable workflow hints, form-fill plans, change diffs, and failure evidence.\n\n**Pricing:** pay-per-call in USDC on Base. No subscriptions, no API keys. See per-tool prices below.\n\n## Install — Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"agentutility-browser-workflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentutility/mcp-browser-workflow\"],\n      \"env\": { \"X402_PRIVATE_KEY\": \"0xYOUR_PRIVATE_KEY_HEX\" }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. 3 tools appear in the tool palette.\n\n## Install — Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentutility-browser-workflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentutility/mcp-browser-workflow\"],\n      \"env\": { \"X402_PRIVATE_KEY\": \"0x...\" }\n    }\n  }\n}\n```\n\n## Funding\n\nSend any amount of **USDC on Base mainnet** to the address derived from your `X402_PRIVATE_KEY`. The MCP server uses it to pay for tool calls automatically.\n\nUSDC on Base contract: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`\n\n## Tools (3)\n\n| Tool | Description |\n|---|---|\n| `browser-flow-digest` | (0.02 USDC/call) Browser flow digest API that compresses a recorded trajectory or trace into reusable workflow memory: an ordered step list, the preconditions each step assumes, and failure hints for anything that broke or looked fragile. Built for trajectory-to-steps compression so an agent doesn't replay a full session log every time it repeats a task. Send a trajectory (JSON array of recorded browser actions, or a plain-text trace) and an optional goal, and get back a named workflow with steps, preconditions, failure hints, and reusability notes grounded only in what the trajectory actually shows. Use it as a workflow memory API, a browser automation trace summarizer, or a reusable-recipe generator for repeat browser agent tasks. |\n| `dom-change-diff` | (0.01 USDC/call) DOM diff for two HTML snapshots of the same page or component, built for browser-automation scripts whose CSS selectors quietly break after a site redesign. Send before_html and after_html plus the selectors your workflow watches, and get back per-selector added/removed/moved/attribute-changed status, stale DOM detection for targets that vanished, and selector stability hints: replacement selectors built from an element's id, data-testid, or aria-label so a broken automation step can self-repair. Use it as a browser workflow repair tool, a selector-stability checker, or a pre-flight check before re-running a scraping or RPA script against a site that may have changed. |\n| `form-fill-plan` | (0.02 USDC/call) Form fill plan API that turns an HTML form plus a plain-language goal into an ordered browser form automation plan: selector, field label, value, and action (fill/select/check/uncheck/click) for each step. Built for autofill steps and Playwright form plan generation ahead of a real run. Send form_html, a goal like 'sign up for the newsletter with my email', and any known data values, and get back a step-by-step plan with unresolved fields flagged rather than guessed. Advisory only: the plan is heuristic guidance from static HTML, not a guarantee, and should be verified against the live DOM before executing. Use it as a browser form automation API, an autofill planning tool, or a pre-run checklist generator for RPA and agent browser workflows. |\n\n## How it works\n\n1. Agent calls a tool (e.g. `browser-flow-digest`).\n2. MCP server POSTs to `https://x402.agentutility.ai/browser-flow-digest`.\n3. The endpoint responds **HTTP 402** with payment instructions.\n4. The MCP server signs an EIP-3009 USDC transfer authorization with `X402_PRIVATE_KEY` and retries.\n5. CDP facilitator settles on Base.\n6. The endpoint returns the actual response.\n\nThe agent never sees the payment flow — it just gets the result.\n\n## Links\n\n- Cluster overview: https://agentutility.ai/browser-workflow/\n- All MCP packages: https://mcp.agentutility.ai/\n- Source: https://github.com/rooz21/x402/tree/main/packages/mcp-browser-workflow\n\n---\n\n**Version:** 0.1.3 · **License:** MIT\n","readmeFilename":"README.md"}