Skip to main content
Glama

CI License: MIT Python 3.11+ MCP REST API Docker Code Quality Stars


The Problem

AI agents suffer from Context Drift, Illusion of Completion, and Quality Degradation:

❌ Mark tasks DONE but leave empty pass statements
❌ Skip critical error handling
❌ Generate unstyled "developer art" UIs  
❌ Write superficial tests with no real assertions
❌ No accountability — human must review everything manually

Related MCP server: checkyourself

The Solution

Verdict is a programmatic gatekeeper that sits between the AI agent and your codebase. Every task must pass all three gates before being marked complete:


Features


Quick Start

1. Install

pip install verdict-mcp
# OR from source:
git clone https://github.com/Zubair-z/VERDICT-MCP.git
cd VERDICT-MCP
pip install -r requirements.txt

2. Scaffold a project

verdict init myproject
cd myproject

This creates: plan.md + auth_handler.py + db_handler.py + tests/test_auth_handler.py

3. Run as MCP Server (for AI agents)

python -m verdict_mcp

4. Run as REST API (for any HTTP client)

python -m verdict_mcp.api_server
# → http://localhost:8000
curl http://localhost:8000/health

5. Run full validation pipeline

curl -X POST http://localhost:8000/pipeline/run \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": "TASK_001",
    "source_files": ["auth_handler.py"],
    "test_file": "tests/test_auth_handler.py",
    "target_file": "auth_handler.py",
    "ui_file": "main_window.py"
  }'

Architecture

graph LR
    A[AI Agent] -->|MCP / HTTP| B{Verdict}
    B --> C[AST Auditor]
    B --> D[UI Enforcer]
    B --> E[Test Runner]
    C --> F[pass/TODO/err/docstring checks]
    D --> G[glassmorphism/neon/layout]
    E --> H[pytest + coverage + mutation]
    F & G & H --> I{TASK COMPLETED?}
    I -->|Yes| J[Git Snapshot]
    I -->|No| A

API Endpoints

Method

Path

Description

GET

/health

Server health

POST

/plan/init

Initialize plan

GET

/plan/summary

Get task states

GET

/plan/task/{id}

Task details

POST

/audit

AST audit files

GET

/ui/style-guide

Design tokens

POST

/ui/validate

Validate UI

POST

/tests/run

Coverage + mutation

GET

/coverage

Coverage report

POST

/pipeline/run

Full lifecycle


Multi-Language Support

Language

Extensions

Checks Applied

Python

.py

Full AST audit (pass, TODO, try-except, docstrings)

JavaScript

.js

TODO, empty functions, missing try-catch

TypeScript

.ts

TODO, empty functions, missing try-catch

React

.jsx, .tsx

TODO, empty components, missing error handling

Go

.go

TODO, empty funcs, missing error handling

Rust

.rs

TODO, empty fn, missing error handling

Java

.java

TODO, empty methods, missing try-catch

Kotlin

.kt

TODO, empty fun, missing error handling


CLI Commands

# Scaffold a new project
verdict init myproject

# Run Verdict checks on current project
verdict verify

# Start MCP server
python -m verdict_mcp

# Start REST API
python -m verdict_mcp.api_server

# Run tests locally
python -m pytest tests/ -v --cov=verdict_mcp --cov-report=term-missing

Docker

# Start REST API
docker-compose up verdict-mcp

# Start MCP stdio mode
docker-compose up verdict-mcp-stdio

VS Code Extension

  1. Copy .vscode-extension/ folder to ~/.vscode/extensions/verdict-mcp/

  2. Restart VS Code

  3. Open a Python file → press Ctrl+Shift+V

  4. Or enable auto-audit on save in settings


Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.


A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Zubair-z/VERDICT-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server