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:

• 14 MCP Servers — Code Validator, Contracts Introspection, RevealUI Docs, Neon, Next.js DevTools, Playwright, RevealUI Content, RevealUI Email, RevealUI Memory, RevealUI Stripe, Stripe, Supabase, Vercel, and an Email Provider helper. Ground-truth count is enforced by pnpm validate:claims.
• 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
│   │   └── README.md
│   └── 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.

pnpm mcp:vercel

3. Stripe

Status: Available (requires API key)

Payment processing and billing operations.

pnpm mcp:stripe

4. Neon

Status: Available (requires API key)

Database operations and SQL queries.

pnpm mcp:neon

5. Supabase

Status: Available (requires API key)

Supabase project management and CRUD operations.

pnpm mcp:supabase

6. Playwright

Status: Available

Browser automation and web scraping.

pnpm mcp:playwright

7. Next.js DevTools

Status: Available

Next.js 16+ runtime diagnostics and automation.

pnpm mcp:next-devtools

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

# Supabase MCP
SUPABASE_URL=https://....supabase.co
SUPABASE_ANON_KEY=eyJ...
SUPABASE_SERVICE_ROLE_KEY=...

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

Package Scripts (Root)

# Start individual MCP servers
pnpm mcp:vercel
pnpm mcp:stripe
pnpm mcp:neon
pnpm mcp:supabase
pnpm mcp:playwright
pnpm mcp:next-devtools

# Setup MCP configuration
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