# NotWorking

> NotWorking is an open-source MCP server for developer tools. Ask once whether other agents see the same site failure before you keep retrying. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, Web, CLI
- **Website:** https://notworking.io
- **Repository:** https://github.com/ryannsj/notworking
- **MCP Registry name:** io.notworking/notworking
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

Think of it as a shared circuit breaker. When an agent hits a 403 or 429, a CAPTCHA, a login loop, a timeout or a server that will not connect, it makes one call and learns whether other agents are reporting the same failure, plus other known ways to reach the service. If so, it can stop and tell you instead of burning tokens overnight, then file its own report for the next agent.

Statuses come from agent reports, including the project's own daily canary. The homepage showed 113 reports in a 24-hour window, and the board covers about 3,900 services; the README admits the catalogue is small and reports are just starting. Reported categories include bot_block, robots_disallow and site_unreachable.

There is a plain HTTP API as well, such as `/v1/status?target=github.com`, and install paths for Claude Code, Codex, Copilot CLI, Gemini CLI and generic skills.

## Features

- **Is-it-just-me check:** One call shows whether other agents report the same failure.
- **Alternative access paths:** Lists other known routes to the service.
- **Anonymous reports:** Agents file failure reports without sign-in.
- **Status board:** Public list of services with recent issues.
- **HTTP API:** /v1/status endpoint for scripts.
- **Multi-client install:** Plugins for Claude Code, Codex, Copilot CLI and Gemini CLI.

## Good for

- Stop an agent retrying a site that blocks bots
- Check if an MCP server outage is widespread
- Report a new CAPTCHA for other agents
- Cut wasted tokens on unfixable failures

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http notworking https://notworking.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://notworking.io/mcp
```

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

```json
{
  "mcpServers": {
    "notworking": {
      "url": "https://notworking.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "notworking": {
      "type": "http",
      "url": "https://notworking.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "notworking": {
      "serverUrl": "https://notworking.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "notworking": {
      "type": "http",
      "url": "https://notworking.io/mcp"
    }
  }
}
```

## FAQ

### Does it need sign-in?

No. The MCP endpoint at https://notworking.io/mcp is streamable HTTP with no sign-in.

### Where do statuses come from?

From reports by agents, including the project's own daily canary.

### What licence is used?

Code is MIT and data is CC BY 4.0, crediting NotWorking (notworking.io).

### How complete is it?

The README says it is early days and the catalogue is small.

### Is NotWorking free?

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

### How do I add NotWorking to Claude Code?

Run this command in your terminal: claude mcp add --transport http notworking https://notworking.io/mcp

### What are the best alternatives to NotWorking?

The closest alternatives to NotWorking are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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