MCP.so
Sign In

Node Mantis MCP ServerVerifiedFeatured

@Anton Zuyeu

Basic information

Category

Browser Automation

Last updated

License

MIT

Author

Anton Zuyeu

Submitted by

Anton

About Node Mantis MCP Server

Web automation for AI assistants. Ask for a task on a website in plain English and Node Mantis carries it out in a real browser, then hands back the result as structured data.

Node Mantis MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "node-mantis": {
      "command": "npx",
      "args": [
        "-y",
        "node-mantis",
        "mcp"
      ],
      "env": {
        "NODEMANTIS_API_KEY": "<your-node-mantis-api-key>"
      }
    }
  }
}

Node Mantis MCP Server tools

4

Carry out a task on a website from a plain-English goal: navigate, click, type, fill in forms and read the outcome, in a real browser. Returns the outcome and, when result_schema is given, the data in that shape. If the task is still going when the call returns, the reply has status "running" and a task_id: call get_task with it. Each call starts a fresh browser session with no saved logins.

Open one page and read data from it without changing anything on it. Returns the data, shaped by result_schema when given. Use run_task instead when getting to the data takes clicking, typing or several pages. If reading is still going when the call returns, the reply has status "running" and a task_id: call get_task with it.

Wait for a task started by run_task or retrieve_data and return its status, latest progress and, once finished, its result. Returns as soon as the task finishes, or after wait_seconds with status "running" (call again). Tasks are kept for an hour after they finish and are lost when this server restarts.

Stop a running task and close its browser. A task that already finished is left unchanged.

Overview

What is Node Mantis

Node Mantis is web automation for AI assistants. Once it is added to an assistant that supports MCP, the assistant can carry out tasks on websites for you. You describe the task in plain English, Node Mantis works through the site in a real browser, and the result comes back as structured data.

How to use Node Mantis

  1. Create an API key in the Node Mantis dashboard at https://nodemantis.com/app.
  2. Add the configuration from the Config tab to your assistant. The server starts with npx -y node-mantis mcp, or uvx node-mantis mcp if you prefer Python.
  3. Ask your assistant for something on a website, for example "find the three cheapest paperbacks on this bookshop site and return title and price".

Setup steps for Claude Code, Claude Desktop, Cursor, VS Code and Codex are in the docs: https://nodemantis.com/docs/mcp

Key features of Node Mantis

  • Carries out website tasks. Give a goal in plain English and it works through the site like a person would: clicking, typing, and handling forms, dropdowns and date pickers.
  • Returns structured results. Supply a JSON Schema and the result comes back as data that matches it.
  • Runs long tasks in the background. A task that takes minutes keeps running while the assistant checks progress or cancels it.
  • Four tools. run_task carries out a task, retrieve_data reads data from a page without acting on it, get_task returns status and results, cancel_task stops a running task.
  • Node.js or Python. The server ships inside the node-mantis package on npm and PyPI.

Use cases of Node Mantis

  • Filling in and submitting multi-step web forms from data the assistant already has.
  • Collecting listings, prices or search results from a site into a table or JSON.
  • Looking something up on a site that has no API and reporting back.
  • Repeating the same website task across many inputs.

Frequently asked questions

1

What do I need to run it

Node.js or Python, Google Chrome, and a Node Mantis API key.

2

How do long tasks work

A call waits up to 45 seconds. If the task is still running, it returns a task id and the assistant checks back with `get_task` until the result is ready.

3

Can I control the shape of the result

Yes. Pass a JSON Schema with the task and the result is returned as data that follows it.

4

Where is the source code

The MCP layer is open source under the MIT licence at https://github.com/Node-Mantis/node-mantis-mcp.

Comments

More Browser Automation MCP servers