ChittyMCP - Consolidated Model Context Protocol Server

Version: 3.0.0 Account: ChittyCorp LLC (0bc21e3a5a9de1a4cc843be9c3e98121) Deployment: https://chittymcp.chittycorp-llc.workers.dev Portal Access: Via platform worker host routing at mcp.chitty.cc

Overview

ChittyMCP is the consolidated MCP (Model Context Protocol) server for the ChittyOS ecosystem, combining:

• Executive MCP Tools - AI-powered business decision making and delegation
• OAuth Integration - Portal authentication and linked app flows
• Cross-Sync - Device and session synchronization for MCP servers
• MCP Agent - Full MCP protocol implementation with tool execution

Architecture

┌─────────────────────────────────────────────────────────────┐
│                        ChittyMCP                            │
│              Consolidated MCP Server v3.0.0                 │
├─────────────────────────────────────────────────────────────┤
│  Components:                                                │
│  ├── src/index.js                Main worker entry point   │
│  ├── src/mcp-agent.js            Full MCP protocol agent   │
│  ├── src/executive-server.js     Executive AI tools        │
│  ├── src/mcp-cross-sync-config.js Cross-device sync        │
│  ├── src/chittymcp.js            Legacy MCP tools          │
│  └── src/mcp-worker.js           Worker utilities          │
├─────────────────────────────────────────────────────────────┤
│  Bindings:                                                  │
│  ├── PLATFORM_KV                 Cross-sync state storage  │
│  └── PLATFORM_CACHE              Session cache             │
└─────────────────────────────────────────────────────────────┘

Features

1. Executive MCP Tools

AI-powered business capabilities:

• make_executive_decision - Strategic decision analysis and recommendations
• delegate_task - Intelligent task routing to ChittyOS subsystems
• analyze_performance - Performance metrics and analysis
• strategic_planning - Business roadmap generation
• risk_assessment - Risk evaluation and mitigation

2. OAuth & Portal Integration

Authentication flows for portal.chitty.cc:

• Portal authentication via Cloudflare Access JWT
• Linked app OAuth2 authorization code flow
• Token exchange and session management
• ChittyID integration for identity validation

3. Cross-Device MCP Synchronization

Sync MCP state across devices:

• Register MCP servers for cross-sync
• Synchronize state between devices (up to 5 per user)
• Session persistence via KV storage
• Device registry and management

4. MCP Protocol Implementation

Full MCP protocol support:

• Tool listing and discovery
• Tool execution with structured I/O
• Resource management
• Prompt templates
• Server-to-server communication

API Endpoints

Health & Info

• GET /health - Service health check
• GET / - Service information and capabilities

MCP Tools

• GET /v1/mcp/tools - List available MCP tools
• POST /v1/mcp/execute - Execute an MCP tool

Cross-Sync

• POST /v1/mcp/cross-sync/register - Register MCP server for sync
• GET /v1/mcp/cross-sync/status - Get sync status for user
• POST /v1/mcp/cross-sync/sync - Sync device state
• GET /v1/mcp/cross-sync/servers - Get synced servers

OAuth (Delegated to Platform)

• /v1/mcp/portal/authenticate - Portal authentication (redirects to platform)
• /v1/mcp/linked-app/oauth - OAuth authorization (redirects to platform)
• /v1/mcp/linked-app/token - Token exchange (redirects to platform)

Installation

# Install dependencies
npm install

# Run locally
npm run dev

# Deploy to production
npm run deploy

# Deploy to staging
npm run deploy:staging

# Monitor logs
npm run tail

Configuration

Environment variables (set in wrangler.toml):

• ENVIRONMENT - Deployment environment (production/staging/development)
• MCP_VERSION - MCP server version
• CHITTYOS_DOMAIN - Base domain for ChittyOS services
• PORTAL_DOMAIN - Portal domain for OAuth redirects
• CROSS_SYNC_ENABLED - Enable cross-device synchronization
• EXECUTIVE_MODE - Enable executive AI tools
• OAUTH_ENABLED - Enable OAuth flows
• CHITTYID_SERVICE_URL - ChittyID authority URL
• AUTH_SERVICE_URL - Authentication service URL

Usage Examples

Execute Executive Decision Tool

const response = await fetch('https://chittymcp.chittycorp-llc.workers.dev/v1/mcp/execute', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  },
  body: JSON.stringify({
    tool: 'make_executive_decision',
    arguments: {
      context: 'Choose between in-house development or outsourcing',
      options: ['Build internal team', 'Hire agency', 'Hybrid approach'],
      urgency: 'high'
    }
  })
});

Register MCP Server for Cross-Sync

const response = await fetch('https://chittymcp.chittycorp-llc.workers.dev/v1/mcp/cross-sync/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-User-ID': 'user-123'
  },
  body: JSON.stringify({
    id: 'my-mcp-server',
    name: 'My Custom MCP Server',
    url: 'https://my-server.example.com',
    capabilities: ['tools', 'resources']
  })
});

Sync MCP State Across Devices

const response = await fetch('https://chittymcp.chittycorp-llc.workers.dev/v1/mcp/cross-sync/sync', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-User-ID': 'user-123',
    'X-Device-ID': 'device-456'
  },
  body: JSON.stringify({
    tools: { /* tool states */ },
    sessions: { /* session data */ }
  })
});

Development

# Project structure
chittymcp/
├── src/
│   ├── index.js                   # Main worker entry point
│   ├── mcp-agent.js              # MCP protocol implementation
│   ├── executive-server.js       # Executive AI tools
│   ├── mcp-cross-sync-config.js  # Cross-sync logic
│   ├── chittymcp.js              # Legacy tools
│   └── mcp-worker.js             # Worker utilities
├── package.json                   # NPM configuration
├── wrangler.toml                  # Cloudflare Workers config
└── README.md                      # This file

# Symlinked from services directory
chittyos-services/chittymcp -> ../chittymcp

Integration with Portal

The portal at portal.chitty.cc integrates with ChittyMCP through:

1. Platform Worker - Unified routing via chittyos-platform-production
2. Host Headers - Route to mcp.chitty.cc for MCP tools
3. OAuth - Authentication via platform worker at auth.chitty.cc
4. Cross-Sync - Session persistence across Claude Desktop and web clients

Testing

# Run test suite
npm test

# Manual testing
curl https://chittymcp.chittycorp-llc.workers.dev/health
curl https://chittymcp.chittycorp-llc.workers.dev/v1/mcp/tools

Deployment

Deployed to ChittyCorp LLC account via Wrangler:

# Production deployment
wrangler deploy

# View logs
wrangler tail chittymcp

# Check deployment status
wrangler deployments list --name chittymcp

Integrated MCP Sources

ChittyMCP consolidates multiple MCP servers from across the ChittyOS ecosystem:

Fully Integrated

• ✅ Executive MCP (~/.claude/tools/chittyos-executive-mcp) - Business decision tools
• ✅ OAuth Agent (chittyos-services/chittyauth/src/mcp-agent.js) - Portal authentication
• ✅ Cross-Sync - Device/session synchronization

Referenced (Symlinked)

• 🔗 Extension Tools (~/.claude/tools/chittyos-mcp-extension) - Desktop integration, legal tools
• 🔗 Cloudflare MCP (~/.claude/tools/chittyos-cloudflare-mcp) - Infrastructure management
• 🔗 Registry Agents (chittyos-services/chittyregistry/src/mcp-agent*.ts) - Service discovery
• 🔗 Router MCP (chittyos-services/chittyrouter/src/mcp-*.js) - HTTP adapter

Tool Categories

Executive & Strategy (5 tools):

• make_executive_decision, delegate_task, analyze_performance, strategic_planning, risk_assessment

Legal & Compliance (7 tools from extension):

• generate_chitty_id, create_legal_case, analyze_document, process_payment, compliance_check, search_cases, execute_workflow

Infrastructure (Cloudflare tools):

• Deploy workers, manage R2/D1/KV, infrastructure tracking

Cross-Sync (3 tools):

• register_mcp_server, sync_mcp_state, get_synced_servers

Symlink Structure

To avoid disk space issues, external MCPs are symlinked:

# Main chittymcp location
/Users/nb/.claude/projects/-/CHITTYOS/chittymcp/

# Symlink from services
chittyos-services/chittymcp → ../chittymcp

# External MCPs (referenced, not copied)
~/.claude/tools/chittyos-executive-mcp/
~/.claude/tools/chittyos-mcp-extension/
~/.claude/tools/chittyos-cloudflare-mcp/

Related Services

• ChittyAuth - OAuth and authentication (auth.chitty.cc)
• ChittyOS Platform - Unified service router (chittyos-platform-production)
• Portal - MCP Portal interface (portal.chitty.cc)
• ChittyID - Identity authority (id.chitty.cc)
• Registry - Service discovery and metadata
• Router - AI-powered email routing

License

MIT License - ChittyCorp LLC

Last Updated: Oct 3, 2025 Maintained by: ChittyOS Team Note: Disk space optimized via symlinks to external MCP sources