title: "@revealui/mcp" description: "Model Context Protocol (MCP) - Complete Integration Package" visibility: public status: verified audience: user

@revealui/mcp

Commercial package - requires a RevealUI Pro license. Free to install and evaluate; a license key is required for production use.

Model Context Protocol (MCP) - Complete Integration Package

Centralized MCP server infrastructure, configuration, and documentation for RevealUI.

Overview

This package contains everything MCP-related:

• 13 MCP Servers - Code Validator, Contracts Introspection, RevealUI Docs, Neon, Next.js DevTools, Playwright, RevealUI Content, RevealUI Email, RevealUI Memory, RevealUI Stripe, Stripe, Vercel, and the Adapter base (BaseAdapter with retry and idempotency, plus the Vercel/Stripe/Neon adapter subclasses). This roster matches the CI counter in scripts/validate/claim-drift.ts (adapter counted, the underscore-prefixed email-provider utility not); the count is enforced by pnpm validate:claims. Of the 13, eight are RevealUI-authored and five are first-party launchers that start vendor MCP server packages.
• MCPHypervisor (incubating) - Multi-server process manager in source (src/hypervisor.ts). Not started by apps at boot today (ADR-007). Use revealui-mcp / per-server launchers for day-to-day attach.
• Configuration Templates - For Claude Code / Claude Desktop
• Utilities - Config management, database adapters
• Documentation - Complete guides and per-server docs
• Database Migrations - MCP-related schema

Pro Package - @revealui/mcp is published to the public npm registry under the RevealUI Pro license (FSL-1.1-MIT). Install: pnpm add @revealui/mcp

Quick Start

1. Install Dependencies

# In the monorepo:
pnpm install

# As an external Pro subscriber:
pnpm add @revealui/mcp

2. Configure MCP Client

# Use template for your IDE
cp packages/mcp/configs/claude-template.json ~/.claude/config.json

# Replace <REPO_PATH> with actual path
sed -i "s|<REPO_PATH>|$(pwd)|g" ~/.claude/config.json

3. Test Server

# Test code validator
tsx packages/mcp/src/servers/code-validator.ts
# Should start (Ctrl+C to exit)

Structure

packages/mcp/
├── src/
│   ├── servers/          # MCP server implementations (run `ls packages/mcp/src/servers/` for the current list)
│   │   ├── code-validator.ts   ← AI code standards enforcer
│   │   └── …                   ← Neon, Next.js DevTools, Playwright, RevealUI-*, Stripe, Supabase, Vercel
│   ├── config/           # Configuration utilities (index.ts, config.json)
│   └── adapters/         # Database adapters (db.ts)
├── configs/              # Template configurations
│   ├── claude-template.json
│   └── README.md
├── docs/                 # Complete documentation
│   ├── INDEX.md          ← Start here
│   ├── README.md         # Main MCP guide
│   ├── SETUP.md          # Setup instructions
│   └── servers/          # Per-server documentation
│       └── code-validator.md
└── package.json

Available MCP Servers

1. Code Validator ⭐

Status: ✅ Active and configured

Prevents AI-generated technical debt by validating code before it's written.

• Rules: console.log, any types, TODO refs, debugger, skip tests
• Integration: Pre-commit hook + MCP server
• Docs: docs/servers/code-validator.md

tsx packages/mcp/src/servers/code-validator.ts

2. Vercel

Status: Available (requires API key)

Deploy and manage Vercel projects.

tsx packages/mcp/src/servers/vercel.ts

3. Stripe

Status: Available (requires API key)

Payment processing and billing operations.

tsx packages/mcp/src/servers/stripe.ts

4. Neon

Status: Available (requires API key)

Database operations and SQL queries.

tsx packages/mcp/src/servers/neon.ts

5. Playwright

Status: Available

Browser automation and web scraping.

tsx packages/mcp/src/servers/playwright.ts

6. Next.js DevTools

Status: Available

Next.js 16+ runtime diagnostics and automation.

tsx packages/mcp/src/servers/next-devtools.ts

8. Contracts Introspection

Status: ✅ Active (no API key required, not Pro-license-gated)

Phase 1 of the protocol-pyramid ADR (docs/decisions/2026-05-03-contracts-protocol-pyramid.md). Exposes every @revealui/contracts category (representation, entities, content, admin, agents, security, secrets, a2a, api-auth, api-chat, api-gdpr, content-validation, devkit-profiles, generated, providers, stripe-webhook-events) as MCP resources (read-only JSON Schemas of every category schema) and matching MCP tools that parse arbitrary JSON against any registered schema.

• Resources: revealui-contracts://catalog (full discovery payload) + revealui-contracts://<category> (one per category, returns all schemas).
• Tools: contracts_list_categories, contracts_get_schema, plus one contracts_validate_<category> per category.
• License: intentionally NOT Pro-gated. @revealui/contracts is MIT and agent-side schema introspection is meant to enable any MCP client (Claude Code, Cursor, custom agents) to integrate cleanly.

tsx packages/mcp/src/servers/contracts.ts

Configuration

All configuration templates are in configs/:

• claude-template.json - Claude Code / Claude Desktop

See configs/README.md for details.

Environment Variables

# Code Validator (no env vars needed)

# Vercel MCP
VERCEL_API_KEY=vercel_...

# Stripe MCP
STRIPE_SECRET_KEY=sk_test_...

# Neon MCP
NEON_API_KEY=neon_...

Documentation

📚 Complete Documentation Index

• Main Guide - MCP overview
• Setup Guide - Configuration steps
• Code Validator - Validator guide

Development

# Build package
pnpm build

# Run tests
pnpm test

# Type check
pnpm typecheck

# Lint
pnpm lint

Running servers

There are no root pnpm mcp:* script aliases. Start a server with tsx against the file under src/servers/ (underscore-prefixed files are helpers, not counted servers):

# Examples (from monorepo root)
tsx packages/mcp/src/servers/code-validator.ts
tsx packages/mcp/src/servers/vercel.ts
tsx packages/mcp/src/servers/stripe.ts
tsx packages/mcp/src/servers/neon.ts
tsx packages/mcp/src/servers/playwright.ts
tsx packages/mcp/src/servers/next-devtools.ts
tsx packages/mcp/src/servers/contracts.ts
tsx packages/mcp/src/servers/docs.ts

# Copy Claude config template
pnpm setup:mcp

Exports

// Config utilities
import { getMcpConfig } from '@revealui/mcp/config'

Migration from Old Structure

This package consolidates MCP code from multiple locations:

Before:

• scripts/mcp/ → Now src/servers/
• packages/config/src/mcp/ → Now src/config/
• Multiple config files → Now configs/ templates
• Scattered docs → Now docs/

After:

• Everything in packages/mcp/ ✅

Related Documentation

• Root MCP Guide
• Automation Guide - AI agent integration
• Project Overview - Framework overview

References

• Model Context Protocol Specification
• Anthropic MCP Servers
• MCP SDK Documentation

License

FSL-1.1-MIT (Fair Source — converts to MIT after 2 years). See LICENSE.

Status: ✅ Consolidated and Active Servers: 13 available (ground truth: pnpm validate:claims — source of truth is packages/mcp/src/servers/) Last Updated: 2026-05-03