Stylemcp

StyleMCP

Executable brand rules for AI models and agents. Keep every AI-generated message on-brand.

What is StyleMCP?

StyleMCP validates and rewrites AI-generated text to match your brand voice. Use it as:

• REST API - Validate text from any application
• MCP Server - Direct integration with Claude and other AI agents
• CLI - Check copy in your terminal or CI/CD
• GitHub Action - Catch off-brand copy in pull requests

Quick Start

API

curl -X POST https://stylemcp.com/api/validate \  -H "Content-Type: application/json" \  -d '{"text": "Click here to learn more!"}'

Response:

{  "valid": false,  "score": 65,  "violations": [    {      "rule": "no-click-here",      "severity": "error",      "message": "Avoid 'click here' - describe the destination instead",      "suggestion": "Learn more about our features"    }  ]}

CLI

# Installnpm install -g stylemcp
# Validate textstylemcp validate "Click here to learn more"
# Validate filestylemcp validate src/copy/homepage.json --pack saas
# Rewrite textstylemcp rewrite "Please utilize our product" --mode aggressive

MCP (Claude Desktop)

Add to your claude_desktop_config.json:

{  "mcpServers": {    "stylemcp": {      "command": "npx",      "args": ["stylemcp"]    }  }}

Now Claude can validate and rewrite text using your brand rules.

API Endpoints

Style Packs

StyleMCP uses style packs - YAML files that define your brand rules.

Available Packs

Example: saas Pack

• Vocabulary: Prefer "use" over "utilize", "help" over "assist"
• Forbidden words: "synergy", "leverage", "cutting-edge", "game-changing"
• Patterns to avoid: "click here", "we're sorry for any inconvenience"
• CTA rules: Avoid "Submit", "Click here", "OK" - prefer "Save", "Create", "Sign up"

Pack Structure

packs/  my-brand/    manifest.yaml      # Pack metadata    voice.yaml         # Tone, vocabulary, forbidden words    copy_patterns.yaml # Reusable copy templates    cta_rules.yaml     # Button/CTA guidelines    tokens.json        # Design tokens (optional)

Create Your Own Pack

# Copy the default packcp -r packs/saas packs/my-brand
# Edit the rulesnano packs/my-brand/voice.yaml
# Use your packcurl -X POST https://stylemcp.com/api/validate \  -d '{"text": "Your text", "pack": "my-brand"}'

voice.yaml Example

tone:  summary: "Friendly, clear, and helpful"  attributes:    - name: friendly      weight: 0.8    - name: professional      weight: 0.7
vocabulary:  rules:    - preferred: "use"      avoid: ["utilize", "leverage"]    - preferred: "help"      avoid: ["assist", "facilitate"]
  forbidden:    - "synergy"    - "paradigm shift"    - "game-changing"
doNot:  - pattern: "click here"    reason: "Poor accessibility"    suggestion: "Describe the destination"    severity: error
  - pattern: "\\b(obviously|simply|just)\\b"    isRegex: true    reason: "Can make users feel stupid"    severity: warning

Self-Hosting

Docker

# Clone the repogit clone https://github.com/3DUNLMTD/stylemcp.gitcd stylemcp
# Set up environmentecho "STYLEMCP_API_KEY=$(openssl rand -hex 32)" > .env
# Run with Dockerdocker compose up -d
# Check healthcurl http://localhost:3000/health

Manual

# Install dependenciesnpm install
# Buildnpm run build
# Start servernpm start

GitHub Actions

name: Brand Checkon: [pull_request]
jobs:  validate:    runs-on: ubuntu-latest    steps:      - uses: actions/checkout@v4
      - name: Validate copy        run: |          npx stylemcp validate src/copy/*.json \            --min-score 80 \            --format github

Environment Variables

MCP Tools

When used as an MCP server, StyleMCP provides these tools:

What Gets Validated?

The saas pack checks for:

Vocabulary

• Use simple words: "use" not "utilize", "help" not "assist"
• Avoid jargon: "synergy", "leverage", "paradigm shift"
• Avoid weak intensifiers: "very", "really", "extremely"

Patterns

• No "click here" (accessibility issue)
• No "we're sorry for any inconvenience" (corporate non-apology)
• No double "please" (sounds desperate)
• No starting with "Sorry" (lead with solutions)

CTAs

• Avoid generic: "Submit", "OK", "Yes/No", "Click here"
• Use specific actions: "Save", "Create", "Sign up", "Export"
• Max 4 words

Constraints

• Max 25 words per sentence
• No exclamation marks (in most contexts)
• First-person plural ("we", "our")
• Oxford comma

License

MIT