# Norma by Quality Clouds

Checks code your agent writes against your stack rules while it is being written, and keeps a record of the findings. Useful when you need a repeatable report instead of a verdict that shifts between runs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: qualityclouds
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qualityclouds/norma-mcp
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/norma-by-quality-clouds

## What it does

Norma plugs into a coding agent as a remote MCP server at `https://api.qualityclouds.ai/mcp`. Rulesets are tied to a stack and switch on by themselves once the server works out what you are running. A single scan of your repository turns on rules across six areas: security, performance, scalability, manageability, maintainability and architecture. The Supabase set by itself holds 12 rules.

The server exposes five tools. `get_rulesets` detects the stack and returns the matching sets, `get_rules_for_ruleset` lists a set's rules with ID, severity and fix guidance, `live_check` runs one file through the rules, `get_open_issues` returns the outstanding findings from the last full scan, and `register_applied_actions` logs what was verified, fixed and prevented. The same file against the same rules yields the same verdict, and file content stays in memory only while the check runs.

One thing to set up first: the repository has to be linked in your Norma account through the GitHub or Bitbucket integration, or `live_check` will not run. Sign-in uses OAuth, and the browser opens on the first connection. If a check reports the repository is not linked, confirm it shows up in your account and that `git remote get-url origin` in your local clone points at the same one.

## Requirements
- Remote server: `https://api.qualityclouds.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http norma https://api.qualityclouds.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add norma-by-quality-clouds --url https://api.qualityclouds.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "norma-by-quality-clouds": {
            "url": "https://api.qualityclouds.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "norma-by-quality-clouds": {
            "type": "http",
            "url": "https://api.qualityclouds.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http norma-by-quality-clouds https://api.qualityclouds.ai/mcp
```

## When to use it
- check a freshly generated file against team rules
- pull the rule list for a stack before starting a task
- work through the open findings from the last full scan
- log which violations were fixed, with file and line numbers
- load the security rules for a Supabase project

## Example prompts
- Detect the stack in this repository and show me which rulesets apply.
- Run `src/api/orders.ts` through Norma and fix what it returns.
- Record which rules passed and what was fixed during this task.

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [Serena MCP: the IDE for your agent](https://affpapa.org/en/nevibecode/mcp/serena-mcp-the-ide-for-your-agent.md) — MCP server · ★ 30677
- [Repomix](https://affpapa.org/en/nevibecode/mcp/repomix.md) — MCP server · ★ 29027
- [Repowise](https://affpapa.org/en/nevibecode/mcp/repowise.md) — MCP server · ★ 7891
- [sem](https://affpapa.org/en/nevibecode/mcp/sem.md) — MCP server · ★ 3422

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md