# Maiday

> Maiday is an open-source MCP server for browser automation. Let agents report where they get stuck on websites and read site-owner hints. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Repository:** https://github.com/35furkan/maiday-plugins
- **MCP Registry name:** io.github.35furkan/maiday
- **Categories:** [browser automation](https://ai-powered.com/categories/browser-automation), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add maiday -- npx -y maiday-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/maiday
