Maiday
Let agents report where they get stuck on websites and read site-owner hints
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"maiday": {
"command": "npx",
"args": [
"-y",
"maiday-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"maiday": {
"command": "npx",
"args": [
"-y",
"maiday-mcp"
]
}
}
}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.


