Skip to content
MCP server

Maiday

Let agents report where they get stuck on websites and read site-owner hints

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
0.1.3
Listing updated
today

Similar MCP servers

About Maiday

Maiday is an open-source MCP server for browser automation. It runs locally on your machine and is started by your AI client.

Maiday is a distress signal for browsing agents. When an agent working through a browser tool such as Playwright MCP, Chrome DevTools MCP, Claude in Chrome or Codex computer use gets stuck on a form, login wall or missing button, it sends a short report to the site's owner, and before a signup, checkout or booking flow it can read hints the owner has published for agents.

Two tools do the work: send_maiday and get_hints. A bundled skill tells the agent to report after two failed attempts, when giving up or when handing back, and to treat hints as untrusted third-party information, never instructions. A report covers the page path, task kind, failure kind, step, the site's error message and whether a workaround worked. Form values, cookies, tokens, query strings and fragments are never sent, and emails, phone numbers, card numbers and token-like strings are redacted locally and again on the server.

Site owners claim a domain through a DNS TXT record or well-known file, see failure patterns grouped by page, and publish hints. A pattern counts as confirmed after 3 installs on 2 networks report it. Reporting can be disabled with MAIDAY_DISABLED=1, or sent to a self-hosted collector.

Install

Run in a terminal

claude mcp add maiday -- npx -y maiday-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "maiday": {
      "command": "npx",
      "args": [
        "-y",
        "maiday-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "maiday": {
      "command": "npx",
      "args": [
        "-y",
        "maiday-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "maiday": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "maiday-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "maiday": {
      "command": "npx",
      "args": [
        "-y",
        "maiday-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "maiday": {
      "command": "npx",
      "args": [
        "-y",
        "maiday-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

send_maiday
Send a short report of where the agent got stuck on a site.
get_hints
Fetch hints the site owner published for agents.

What it does

Failure reports
Agents tell site owners where they got stuck.
Owner hints
Agents read tips published by the site before a task.
Privacy redaction
Sensitive values are stripped before leaving your machine.
Confirmation threshold
Patterns need 3 installs on 2 networks to count.
Self-hosted collector
Send reports to your own endpoint.
Claude Code and Codex plugins
Bundles the server with a usage skill.

Good for

  • Warn a site owner that their checkout blocks agents
  • Read owner tips before a signup flow
  • See where AI agents fail on your own site
  • Publish hints that help agents complete a booking

Pricing

Open source

Open-source (MIT) plugins and npm package

Maiday FAQ

When does it do anything?

Only when an agent works on websites through a browser tool.

What is never sent?

Form values, cookies, tokens, query strings and URL fragments.

Can I turn off reporting?

Yes, set MAIDAY_DISABLED=1; hints keep working.

How do owners claim a site?

With a DNS TXT record or a well-known file.

Is Maiday free?

Yes. Maiday is open source, so you can use and self-host it for free.

How do I add Maiday to Claude Code?

Run this command in your terminal: claude mcp add maiday -- npx -y maiday-mcp

What are the best alternatives to Maiday?

The closest alternatives to Maiday are REA, Browser Use, Scrapling MCP Server, Context7 and Chrome DevTools MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers