# KarmaDue

> KarmaDue is a free MCP server for security. Pre-install safety checks for AI agents: known traps, tested fixes and malware reports. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI
- **Website:** https://karmadue.expo.app/docs/mcp
- **Repository:** https://github.com/ashadow07/karmadue
- **MCP Registry name:** io.github.ashadow07/karmadue
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-15

## About

Before an agent runs npm install, pip install, uv add or adds an MCP server, it can ask this service for a single answer: fix_first with tested steps, warn, deny for a malicious-package report, no_known_issues, or unknown. The README stresses that unknown means no evidence, not safety clearance. The site's example shows a deny for the npm package postmark-mcp, citing a malicious-package report and suggesting an alternative.

Reads need no account, with an anonymous limit of 30 requests an hour per IP. Nothing runs your command, and every fix cites a dated test record. Seed records are labelled as founder-operated assessments, not independent ones. Lockfile installs and transitive dependencies are not covered.

The repository adds shims for npm, pip and uv, a Claude Code pre-install hook and a GitHub Action. The server and database are hosted and are not in the repository. Marketplace payments are in test mode.

## Features

- **Install verdicts:** Returns fix_first, warn, deny, no_known_issues or unknown.
- **Dated evidence:** Each fix cites a test record with a date.
- **Read-only checks:** Nothing executes your command.
- **Install guard shims:** Wrappers for npm, npx, pnpm, yarn, pip and uv check before installing.
- **Claude Code hook:** A PreToolUse hook checks installs automatically.

## Good for

- Check a package before an agent installs it
- Find tested fix steps for a known install problem
- Gate installs in Claude Code with a hook
- Report an outcome so others benefit

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http karmadue https://karmadue--mcp.expo.app/mcp
```

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

```sh
https://karmadue--mcp.expo.app/mcp
```

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

```json
{
  "mcpServers": {
    "karmadue": {
      "url": "https://karmadue--mcp.expo.app/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "karmadue": {
      "type": "http",
      "url": "https://karmadue--mcp.expo.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "karmadue": {
      "serverUrl": "https://karmadue--mcp.expo.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "karmadue": {
      "type": "http",
      "url": "https://karmadue--mcp.expo.app/mcp"
    }
  }
}
```

## Tools

- `check_install`: Check an install target and return a verdict.
- `search_recipes`: Search tested install recipes.
- `report_leaf`: Report a finding.
- `search`: Search resources on the OAuth connector.
- `fetch`: Fetch a resource on the OAuth connector.
- `find_resource`: Find a resource on the safety endpoint.
- `check`: Check a target on the safety endpoint.
- `get_evidence`: Get the evidence behind an answer.
- `request_help`: Ask for help when no answer exists.
- `report_outcome`: Report the outcome of an attempt.

## FAQ

### Do I need an account?

No account or key is needed for reads; the anonymous limit is 30 requests per hour per IP.

### Does unknown mean safe?

No. The README says unknown means no evidence and is not safety clearance.

### What does it not cover?

Lockfile installs such as npm ci and pip install -r, and transitive dependencies.

### What is the licence?

MIT for the repository; the hosted server and database are not part of it.

### Which endpoints use OAuth?

The connector endpoints for Claude and ChatGPT use OAuth 2.1.

### Is KarmaDue free?

Yes. KarmaDue is free to use.

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

Run this command in your terminal: claude mcp add --transport http karmadue https://karmadue--mcp.expo.app/mcp

### What are the best alternatives to KarmaDue?

The closest alternatives to KarmaDue 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/karmadue
