THE MYTH THE HEROES THE VISION FOR DEVELOPERS
TECHNICAL DOCUMENTATION / v1.0.0

THE ARCHITECTURE
OF HEROES

A comprehensive technical reference for The Partenón system — Model Context Protocol design, agent specifications, integration patterns, and deployment guides.

TypeScriptMCP ProtocolStripe APINVIDIAGoogle Workspace
JUMP TO: Architecture,Heroes,MCP,Workshop,Install
ARCHITECTURE

HOW THE PARTENÓN IS BUILT

A layered architecture connecting intelligent agents through the Model Context Protocol, unified by G-Brain and deployed on enterprise-grade infrastructure.

External MCPExternal MCPExternal MCPExternal MCPMission APIMission APIMission APIMission APIMission APIMission APIMission APIMCPMCPMCPMCPMCPMCPMCP Google Workspace Stripe Platform NVIDIA Cloud Nous Research G-BRAIN MCP Orchestrator THE SCRIBE Google Workspace MCP THE HERALD Social APIs MCP THE COLLECTOR Stripe MCP THE GUARDIAN Security MCP THE STRATEGIST Google Workspace MCP THE DIPLOMAT CRM MCP THE BRAIN G-Brain MCP HERMES Enterprise Core
AGENT SPECIFICATIONS

HERO TECHNICAL PROFILES

Each hero is a specialized agent with defined capabilities, MCP tools, API integrations, and file format handlers.

book

THE SCRIBE

MCP Server: Google Workspace MCP

Financial data agent. Handles Google Sheets operations, financial modeling, dashboard creation, and the .finance file format. Built on Google Sheets API with custom query functions and visualization.

Capabilities

Capability MCP Tool API/Integration Output
Financial Modeling create_spreadsheet / append_rows Google Sheets API .finance file
Dashboard Creation update_cells / add_chart Google Sheets API, Chart.js Live dashboard URL
Data Analysis read_range / pivot analysis Google Sheets API Analysis report

MCP Tools

create_spreadsheetappend_rowsread_rangeupdate_cellsexport_report
terminal CLI Example 
$ hermes activate scribe
✓ The Scribe initialized
✓ Google Sheets API connected
✓ .finance parser loaded

$ hermes mission scribe --type financial-model \
  --business "Café Central" --industry cafe

📋 Mission: Build Financial Model
✓ Fixed costs: 4 items
✓ Variable costs: 7 items
✓ Break-even calculation complete
chat

THE HERALD

MCP Server: Social APIs MCP

Communication and marketing agent. Manages social media APIs, brand strategy, SEO/GEO optimization, and the .design file format. Integrates with major social platforms and analytics tools.

Capabilities

Capability MCP Tool API/Integration Output
Social Media Mgmt publish_post / schedule_content Instagram, Twitter, LinkedIn APIs Published content
Brand Strategy generate_brand_guide Internal ML .design file
SEO/GEO Optimizer analyze_keywords / optimize_content Google Analytics SEO report

MCP Tools

publish_postgenerate_brand_guideanalyze_keywordsanalyze_engagementschedule_content
terminal CLI Example 
$ hermes activate herald
✓ The Herald initialized
✓ Social APIs connected
✓ .design parser loaded

$ hermes mission herald --type brand-strategy \
  --audience "young professionals"

📢 Mission: Build Brand Strategy
✓ Voice profile generated
✓ Visual identity mapped
✓ Messaging framework created
credit_card

THE COLLECTOR

MCP Server: Stripe MCP

Payment processing agent. Stripe SDK integration — payments, subscriptions, invoicing, revenue tracking, and fraud monitoring. Handles financial transactions for the enterprise.

Capabilities

Capability MCP Tool API/Integration Output
Payment Processing create_payment_link Stripe API Payment confirmation
Subscription Mgmt create_subscription Stripe Billing Subscription state
Revenue Tracking list_charges / reporting Stripe Sigma Revenue report

MCP Tools

create_payment_linkcreate_invoicecreate_subscriptionlist_chargesmonitor_fraud
terminal CLI Example 
$ hermes activate collector
✓ The Collector initialized
✓ Stripe SDK connected
✓ .revenue parser loaded

$ hermes mission collector --type payment-setup \
  --business "Café Central"

💳 Mission: Setup Payments
✓ Product catalog created
✓ Payment methods configured
✓ Webhook endpoints registered
shield

THE GUARDIAN

MCP Server: Security MCP

Security and AI model management agent. Manages API keys through encrypted vault, NVIDIA GPU allocation, access control policies, and audit logging. Ensures enterprise-grade security across all hero operations.

Capabilities

Capability MCP Tool API/Integration Output
API Key Vault manage_secrets HashiCorp Vault Key policy
GPU Allocation allocate_gpu NVIDIA API GPU config
Access Control set_policies Internal RBAC Policy file

MCP Tools

manage_secretsallocate_gpuset_policiesaudit_logrotate_keys
terminal CLI Example 
$ hermes activate guardian
✓ The Guardian initialized
✓ NVIDIA API connected
✓ Key vault mounted

$ hermes mission guardian --type security-audit \
  --scope "all heroes"

🛡️ Mission: Security Audit
✓ All API keys verified
✓ Access policies updated
✓ Audit log enabled
calendar_month

THE STRATEGIST

MCP Server: Google Workspace MCP

Operations and project management agent. Orchestrates Google Calendar, task queues, email processing, and internal coordination. The central nervous system of project execution.

Capabilities

Capability MCP Tool API/Integration Output
Calendar Sync create_event / list_events Google Calendar API Sync state
Task Management manage_tasks Bull/BullMQ Task queue
Email Processing send_email / parse_threads Gmail API Parsed actions

MCP Tools

create_eventmanage_taskssend_emailschedule_meetingsend_reminder
terminal CLI Example 
$ hermes activate strategist
✓ The Strategist initialized
✓ Google Calendar connected
✓ Task queues ready

$ hermes mission strategist --type project-setup \
  --methodology agile

📅 Mission: Setup Project Mgmt
✓ Calendar synchronized
✓ Task boards created
✓ Reminder system active
groups

THE DIPLOMAT

MCP Server: CRM MCP

Client relationship management agent. Handles CRM operations, external communications, meeting scheduling, and partnership management. The bridge between internal operations and external stakeholders.

Capabilities

Capability MCP Tool API/Integration Output
CRM Operations sync_contacts HubSpot / Salesforce CRM state
Meeting Scheduler schedule_meeting Google Meet API Meeting link
Follow-up Engine auto_followup Email APIs Sent messages

MCP Tools

sync_contactsschedule_meetingauto_followuplog_interactiongenerate_proposal
terminal CLI Example 
$ hermes activate diplomat
✓ The Diplomat initialized
✓ CRM connected
✓ .relations parser loaded

$ hermes mission diplomat --type client-onboard \
  --client "Acme Corp"

🤝 Mission: Onboard Client
✓ CRM profile created
✓ Welcome sequence sent
✓ Meeting scheduled
neurology

THE BRAIN

MCP Server: G-Brain MCP

Central intelligence orchestrator. Manages the MCP protocol layer, cross-agent context sharing, pattern recognition, and strategic insight generation. The meta-agent that makes The Partenón greater than the sum of its parts.

Capabilities

Capability MCP Tool API/Integration Output
Context Sharing share_context MCP Protocol Shared context
Pattern Analysis find_patterns Internal ML Insight report
MCP Orchestration orchestrate_agents MCP SDK Agent mesh

MCP Tools

share_contextfind_patternsorchestrate_agentsregister_agentgenerate_insight
terminal CLI Example 
$ hermes activate brain
✓ G-Brain initialized
✓ MCP Hub started

$ hermes mission brain --type cross-agent-analysis \
  --scope "all heroes" --pattern "revenue"

🧠 Mission: Cross-Agent Analysis
✓ All contexts indexed
✓ Pattern correlation complete
✓ 3 strategic insights generated
MODEL CONTEXT PROTOCOL

THE NERVOUS SYSTEM

MCP is the protocol that transforms individual agents into a collective intelligence. Here is how it works inside The Partenón.

mcp.call()mcp.call()mcp.call()mcp.call()mcp.call()mcp.call() Google Workspace MCP Sheets, Calendar, Gmail, Drive Stripe MCP Payments, Billing, Connect NVIDIA MCP GPU, Models, Security Social APIs MCP Instagram, Twitter, LinkedIn CRM MCP HubSpot, Salesforce Hero Agent Pool scribe, herald, collector... G-BRAIN MCP Server
01Context Registration
await brain.registerContext({
  agent: 'scribe',
  type: 'financial_model',
  data: financeFile,
  access: ['herald', 'strategist', 'brain'],
  ttl: '30d'
});
02Cross-Agent Discovery
const context = await brain.discover({
  requestedBy: 'herald',
  type: 'financial_model',
  scope: 'latest'
});
// Returns: The Scribe's financial data
03Insight Generation
const insight = await brain.generateInsight({
  pattern: 'correlation',
  sources: ['scribe.revenue', 
    'herald.campaigns', 
    'collector.payments'],
  output: 'optimization_report'
});

PROTOCOL METHODS

Method Direction Purpose Payload
mcp.register()Hero → BrainRegister agent capabilitiesAgent config, tools, permissions
mcp.context.share()Hero → BrainShare work outputContext type, data, access rules
mcp.context.request()Hero → BrainRequest shared contextContext type, filters
mcp.observe()Brain → HeroSubscribe to eventsEvent patterns, callbacks
mcp.insight.push()Brain → HeroDeliver insightsInsight data, confidence, actions
mcp.tool.call()Brain → ExternalExecute external toolTool name, parameters, auth

JSON-RPC REQUEST EXAMPLE

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "google_sheets_query",
    "arguments": {
      "spreadsheetId": "...",
      "range": "A1:D100"
    }
  }
}
INTEGRATION PATTERNS

HOW DATA FLOWS THROUGH THE PARTENÓN

bolt Example 1: Sale → Financial Update → Marketing

Customer
Stripe
Collector
Brain
Scribe
Sheets
Herald
Social
Customer arrow_forward Stripe Purchase completed
Stripe arrow_forward Collector webhook: payment.success
Collector arrow_forward Brain mcp.context.share(payment_data)
Brain arrow_forward Scribe mcp.context.request(financial_update)
Scribe arrow_forward Sheets Update revenue dashboard
Brain arrow_forward Herald mcp.insight.push(high_performing_product)
Herald arrow_forward Social Boost campaign for product

calendar_month Example 2: Meeting → Tasks → Follow-up

Calendar
Strategist
Brain
Diplomat
CRM
Calendar arrow_forward Strategist Meeting scheduled
Strategist arrow_forward Brain mcp.context.share(meeting_notes)
Brain arrow_forward Diplomat mcp.context.request(client_context)
Diplomat arrow_forward CRM Log interaction
Brain arrow_forward Strategist mcp.insight.push(follow_up_tasks)
Strategist arrow_forward Calendar Create follow-up reminders

shield Example 3: Security Alert → System Response

NVIDIA
Guardian
Brain
All Heroes
Vault
Hermes
NVIDIA arrow_forward Guardian Anomaly detected
Guardian arrow_forward Brain mcp.context.share(security_alert)
Brain arrow_forward All Heroes mcp.observe(security_status)
Guardian arrow_forward Vault Rotate affected keys
Brain arrow_forward Hermes mcp.insight.push(incident_report)

database Google Workspace File Structure 

Google Drive / The Partenón /
├── 📁 enterprises/
│   └── 📁 {enterprise-name}/
│       ├── 📄 enterprise.finance      ← Scribe
│       ├── 📄 enterprise.design       ← Herald
│       ├── 📄 enterprise.revenue      ← Collector
│       ├── 📄 enterprise.security     ← Guardian
│       ├── 📄 enterprise.operations   ← Strategist
│       ├── 📄 enterprise.relations    ← Diplomat
│       ├── 📄 enterprise.brain        ← Brain
│       └── 📁 shared/
│           ├── 📁 dashboards/
│           ├── 📁 campaigns/
│           ├── 📁 reports/
│           └── 📁 meetings/
├── 📁 templates/
│   ├── 📄 default.finance
│   ├── 📄 default.design
│   └── 📄 default.operations
└── 📁 archive/
WORKSHOP PROTOCOL

THE 2-HOUR HERMES INSTALL SESSION

Setup (15min)
Environment prep, dependency install
Onboarding (20min)
Hermes init, enterprise config
Hero Config (30min)
Enable heroes, set API keys
Integration Test (25min)
End-to-end flow test
Q&A (15min)
Open discussion
Next Steps (15min)
Deployment, monitoring
Setup (15min)
Onboarding (20min)
Hero Config (30min)
Integration Test (25min)
Q&A (15min)
Next Steps (15min)
0:00 2:00

Pre-Workshop Checklist

# Pre-workshop requirements
$ node --version  # >= 20.0.0
$ npm --version   # >= 10.0.0

# Required accounts (free tier acceptable)
# ✓ Google account (for Workspace integration)
# ✓ Stripe account (test mode for development)
# ✓ NVIDIA account (API key for security features)

# One-line installation
$ npx create-hermes@latest my-partenon
$ cd my-partenon
$ hermes configure --interactive
description

Workshop Slides

Complete presentation deck for facilitators. Covers Partenón concept, hero introductions, live demo script, and troubleshooting guide.

description

Participant Handbook

PDF guide for workshop attendees. Step-by-step installation instructions, hero configuration cheat sheet, and FAQ.

description

Facilitator Script

Detailed speaking notes for workshop leaders. Timing cues, talking points, and interaction prompts for each phase.

Workshop Formats

Format Duration Audience Capacity Requirements
Webinar (Virtual)2 hoursGlobal entrepreneurs500Zoom + screen share
University Session3 hoursStudents & faculty100Computer lab + projector
Coworking Workshop2.5 hoursCoworking members30Meeting room + WiFi
BNI Chapter Meet2 hoursBusiness network25Conference room
Accelerator CohortFull dayStartup teams20Workshop space + mentors
GET STARTED

INSTALL HERMES IN ONE COMMAND

# One-line installation
$ npx create-hermes@latest my-enterprise

# Follow the interactive wizard
? What type of business?  Cafe / Retail / SaaS / Construction / Other
? Business name:  My Amazing Cafe
? Activate heroes:  [x] Scribe [x] Herald [x] Collector
                     [x] Guardian [x] Strategist [x] Diplomat
? Google account:  user@gmail.com
? Stripe account:  sk_test_...
? NVIDIA API key:  nv-...

# Hermes initializes
✓ Creating enterprise directory
✓ Configuring Google Workspace
✓ Connecting Stripe (test mode)
✓ Setting up NVIDIA security
✓ Activating all 7 heroes
✓ MCP protocol initialized
✓ G-Brain connected

# Access your Partenón
$ hermes dashboard
# → Opens Google Sheets dashboard
# → Starts hero monitoring
# → Launches web interface
# Clone the repository
$ git clone https://github.com/the-parthenon/hermes.git
$ cd hermes

# Install dependencies
$ npm install

# Copy environment template
$ cp .env.example .env
# Edit .env with your API keys

# Build
$ npm run build

# Start
$ npm run start
# Pull the image
$ docker pull ghcr.io/theparthenon/hermes:latest

# Run with environment variables
$ docker run -d \
  --name hermes \
  --env-file .env \
  -p 3000:3000 \
  ghcr.io/theparthenon/hermes:latest

# Or with inline env vars
$ docker run -d \
  --name hermes \
  -p 3000:3000 \
  -e GOOGLE_CLIENT_ID=... \
  -e STRIPE_SECRET_KEY=... \
  -e NVIDIA_API_KEY=... \
  ghcr.io/theparthenon/hermes:latest

REPOSITORY STRUCTURE

the-partenon/
├── 📁 apps/
│   ├── 📁 hermes/           # Main orchestrator
│   ├── 📁 web/              # Next.js marketing site
│   └── 📁 dashboard/        # React admin dashboard
├── 📁 packages/
│   ├── 📁 mcp-sdk/          # Model Context Protocol SDK
│   ├── 📁 heroes/
│   │   ├── 📁 scribe/       # Google Workspace MCP
│   │   ├── 📁 herald/       # Social APIs MCP
│   │   ├── 📁 collector/    # Stripe MCP
│   │   ├── 📁 guardian/     # Security / NVIDIA MCP
│   │   ├── 📁 strategist/   # Google Workspace MCP
│   │   ├── 📁 diplomat/     # CRM MCP
│   │   └── 📁 brain/        # G-Brain MCP
│   ├── 📁 shared/
│   │   ├── 📁 types/        # Shared TypeScript types
│   │   ├── 📁 config/       # Configuration schemas
│   │   └── 📁 utils/        # Common utilities
│   └── 📁 ui/               # Shared UI components
├── 📁 workshops/
│   ├── 📁 slides/           # Presentation decks
│   ├── 📁 handbooks/        # Participant guides
│   └── 📁 facilitator/      # Leader scripts
├── 📄 README.md
├── 📄 CONTRIBUTING.md
├── 📄 LICENSE (MIT)
└── 📄 package.json

ENVIRONMENT VARIABLES

Variable Required Description Example
GOOGLE_CLIENT_ID Yes Google OAuth client ID 123-abc.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET Yes Google OAuth secret GOCSPX-...
STRIPE_SECRET_KEY Yes Stripe API key sk_test_...
STRIPE_WEBHOOK_SECRET Yes Stripe webhook endpoint secret whsec_...
NVIDIA_API_KEY Yes NVIDIA platform API key nv-...
OPENAI_API_KEY Optional OpenAI for advanced features sk-...
KIMI_API_KEY Optional Kimi / Moonshot API key sk-...
MCP_PORT No MCP server port (default: 3001) 3001
HERMES_ENV No Environment (dev/staging/prod) development
API REFERENCE

HERMES COMMAND LINE INTERFACE

CLI Commands

Command Description Example
hermes init Initialize new enterprise hermes init --name "Cafe Central"
hermes activate Activate a hero hermes activate scribe
hermes deactivate Deactivate a hero hermes deactivate herald
hermes mission Start a hero mission hermes mission scribe --type financial-model
hermes status Check system status hermes status --verbose
hermes dashboard Open web dashboard hermes dashboard --port 3000
hermes test Run integration tests hermes test --all
hermes deploy Deploy to production hermes deploy --target vercel
hermes logs View system logs hermes logs --follow --hero scribe
hermes config Edit configuration hermes config --edit
hermes backup Backup enterprise data hermes backup --to google-drive

REST API Endpoints

Endpoint Method Description
/api/v1/heroes GET List all heroes
/api/v1/heroes/:id GET Get hero details
/api/v1/missions POST Create new mission
/api/v1/missions/:id GET Get mission status
/api/v1/mcp/tools GET List available MCP tools
/api/v1/mcp/call POST Call MCP tool

System Status Response

{
  "status": "healthy",
  "version": "1.0.0",
  "heroes": {
    "scribe": { "status": "active", "lastMission": "2025-01-15T10:30:00Z" },
    "herald": { "status": "active", "lastMission": "2025-01-15T09:15:00Z" },
    "collector": { "status": "active", "lastMission": "2025-01-15T08:45:00Z" },
    "guardian": { "status": "active", "lastCheck": "2025-01-15T11:00:00Z" },
    "strategist": { "status": "active", "lastMission": "2025-01-15T10:00:00Z" },
    "diplomat": { "status": "active", "lastMission": "2025-01-14T16:30:00Z" },
    "brain": { "status": "active", "insightsGenerated": 147 }
  },
  "mcp": {
    "connectedAgents": 7,
    "contextObjects": 23,
    "lastInsight": "2025-01-15T10:55:00Z"
  },
  "integrations": {
    "google_workspace": "connected",
    "stripe": "connected",
    "nvidia": "connected"
  }
}

READY TO BUILD?

INSTALL HERMES arrow_forward

checkCopied