MCP Setup - Hermes Intelligence

What is the MCP Server?

The Model Context Protocol (MCP) server allows AI agents like Claude to programmatically access Hermes Intelligence brand assets. Instead of manually looking up colors, logos, or guidelines, AI agents can query the MCP server directly.

Benefits:

Automatically generate brand-compliant materials (presentations, emails, social posts)
Query brand colors, logos, and typography on demand
Validate content against brand guidelines
Access templates and assets programmatically

Who needs this? Internal team members using Claude Desktop or other MCP clients.

Prerequisites

🐍

Python 3.11+

Check: python3 --version

🤖

Claude Desktop

Or any MCP-compatible client

🔐

Internal Access

Restricted to internal users

Installation Steps

Download MCP Server Files

Clone the Hermes Portal repository or download the brand_portal_mcp directory:

git clone https://github.com/Hermes-Intelligence/HermesPortal.git
cd HermesPortal/brand_portal_mcp

Alternative: Download ZIP from internal file share

Install MCP SDK

pip install mcp

Configure Claude Desktop

Add the MCP server to your Claude Desktop configuration:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "hermes-brand": {
      "command": "python3",
      "args": ["/path/to/HermesPortal/brand_portal_mcp/server.py"],
      "env": {
        "BRAND_DATA_PATH": "/path/to/HermesPortal/brand_data.json"
      }
    }
  }
}

⚠️ Important:

Replace /path/to/HermesPortal with the actual path to your HermesPortal directory.

Restart Claude Desktop

Close and reopen Claude Desktop. The MCP server will load automatically.

To verify, ask Claude:

"What brand colors are available?"

Claude should use the get_brand_colors tool to answer.

Available Tools

get_brand_colors

Get color palettes with hex/RGB/CMYK values. Filter by product.

product: "vextrum" | "all"
format: "hex" | "rgb" | "cmyk"

get_logo

Get logo SVG code or download URL for any product.

product: "vextrum" | "agora"
context: "dark" | "light"

search_brand_guidelines

Search brand guidelines by keyword.

query: "presentation fonts"
category: "all" | "logos"

get_typography

Get font specs, CSS, or Google Fonts URLs.

format: "specs" | "css"

get_template

Get template download URLs (presentation, video, email).

type: "presentation" | "video"
name: "Title Slide" (optional)

validate_brand_compliance

Check if content matches brand guidelines.

content_type: "color" | "font"
value: "#2DD4BF" | "Manrope"

Usage Examples

Example 1: Create a Vextrum Presentation

User:

"Create a Vextrum presentation title slide with the brand colors and logo"

Claude uses:

get_logo(product: "vextrum", context: "dark") → Gets logo SVG
get_brand_colors(product: "vextrum") → Gets #2DD4BF
get_typography(format: "specs") → Gets Manrope font specs

Example 2: Check Brand Compliance