# brief bar_

brief bar_ — an MCP server that scores digital product briefs against open rules. Returns a grade, gap list and publication decision.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: welance
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/welance/perfect-brief
- Updated: 2026-10-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/brief-bar

## What it does

The server checks a brief against 14 rules (anonymity, budget, timeline, contacts and others), weighs each and produces a final score. An LLM judges rule compliance, deterministic code calculates the score and makes the publication decision. Every verdict includes a quote from the brief as evidence.

Runs in two modes: instant mock judge (keyword-based, no API) and `llm` judge via OpenRouter. The console accepts PDF, TXT and Markdown up to 10 MB, extracts text locally using PDF.js. Without an API key, fully functional on the mock judge. The public deployment sets a €10k budget floor and requires four gate rules for publication; settings can be changed in your own deployment.

Output includes a band (`Directory-ready`, `Blocked`), list of missing gate requirements, confidence per rule and ruleset version for audit. Caches verdicts by `(ruleset_version, model, brief)` in Redis.

## Requirements
- Remote server: `https://briefs.welance.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http perfect-brief https://briefs.welance.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add brief-bar --url https://briefs.welance.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "brief-bar": {
            "url": "https://briefs.welance.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "brief-bar": {
            "type": "http",
            "url": "https://briefs.welance.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http brief-bar https://briefs.welance.com/mcp
```

## When to use it
- score brief completeness and quality before publishing
- check brief for anonymity and contact leaks
- get a gap list for a spec with quoted evidence
- run brief checks against open rules without external API calls

## Example prompts
- Score the brief in `brief.md` using brief bar_
- Check the spec for publication rule compliance
- Run `project_spec.txt` through brief bar_ and show gaps

## Similar
- [brief-generator](https://affpapa.org/en/nevibecode/skills/brief-generator.md) — skill · 1200 installs
- [brief-section-drafter](https://affpapa.org/en/nevibecode/skills/brief-section-drafter.md) — skill · 660 installs
- [creative-brief](https://affpapa.org/en/nevibecode/skills/rampstackco-creative-brief.md) — skill · 354 installs
- [company-research](https://affpapa.org/en/nevibecode/skills/deanpeters-company-research.md) — skill · 3500 installs
- [legal-writing](https://affpapa.org/en/nevibecode/skills/legal-writing.md) — skill · 1500 installs
- [learning-product](https://affpapa.org/en/nevibecode/skills/learning-product.md) — skill · 651 installs

---
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
