# KnownFix

> KnownFix is a freemium MCP server for developer tools. Catalogue of dev-error fixes for AI agents, with free fixes and paid scoped reviews. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://b-hash88.github.io/knownfix/
- **Repository:** https://github.com/b-hash88/knownfix
- **MCP Registry name:** io.github.b-hash88/knownfix
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Instead of searching the open web, an agent can paste the exact error text from a failed run and have it matched against a curated catalogue of signatures, causes and remedies. The site reports 40 fixes, 14 of them free in full, and says nothing is returned when no entry fits.

Paid items follow a stated flow: search is free, a paid result carries a signed offer for one product and one private payment intent for an hour, and payment is made in USDC through Base Pay or in exact ETH on Base mainnet, then redeemed once. The README gives paid fixes from $0.05 USDC.

Beyond fixes there are six free workflow skills, three free browser-local tools (a connection kit, a response inspector and a webhook retry planner) and ten scoped services such as website audits at $149 or $399 USDC, a $249 codebase review and a $750 homepage build. It connects as a remote Streamable HTTP server or through the npm package over stdio.

## Features

- **Exact-error matching:** Matches pasted error text against catalogued signatures, causes and remedies.
- **Free tier:** Fourteen of forty fixes are free in full, returned straight from search.
- **Signed offers:** Paid fixes return a one-hour offer payable in USDC or ETH on Base.
- **Free browser tools:** Connection kit, response inspector and webhook retry planner run locally in the browser.
- **Workflow skills:** Six free skills are delivered over the same server.
- **Scoped services:** Audits, code reviews and builds with stated scope, price and delivery targets.

## Good for

- Resolve a build or runtime error an agent keeps hitting
- Check an MCP client configuration before connecting
- Plan webhook retry timing against a time budget
- Commission a bounded website or codebase review
- Inspect an MCP server response for problems

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http knownfix https://knownfix-backend-28.b-hash88.deno.net/mcp
```

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

```sh
https://knownfix-backend-28.b-hash88.deno.net/mcp
```

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

```json
{
  "mcpServers": {
    "knownfix": {
      "url": "https://knownfix-backend-28.b-hash88.deno.net/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "knownfix": {
      "type": "http",
      "url": "https://knownfix-backend-28.b-hash88.deno.net/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "knownfix": {
      "serverUrl": "https://knownfix-backend-28.b-hash88.deno.net/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "knownfix": {
      "type": "http",
      "url": "https://knownfix-backend-28.b-hash88.deno.net/mcp"
    }
  }
}
```

## Tools

- `search_fixes`: Searches the fix catalogue; a free top match returns its full body.
- `get_fix`: Returns a fix, or a free preview and signed offer for a paid one.
- `get_skill`: Returns a workflow skill, or an offer for a paid one.

## FAQ

### Is searching free?

Yes. Search is free and signatures are public so a match can be confirmed before paying.

### How do I pay for a fix?

In USDC through Base Pay or exact ETH on Base mainnet, using a signed offer that lasts one hour.

### How much do paid fixes cost?

The README says they start at $0.05 USDC; services are priced separately in USDC.

### How do I connect?

Use the Streamable HTTP URL in your client config, or run npx knownfix bridge for stdio-only clients.

### Does it still work through Smithery?

The site says Smithery proxy connections shut down on October 31, 2026 and advises switching to the direct URL.

### Is KnownFix free?

KnownFix has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add --transport http knownfix https://knownfix-backend-28.b-hash88.deno.net/mcp

### What are the best alternatives to KnownFix?

The closest alternatives to KnownFix 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/knownfix
