Scaling Codes MCP

Transform your IDE into an AI-assisted architecture companion with our Model Context Protocol server

What is Scaling Codes MCP?

The Scaling Codes MCP is a Model Context Protocol server that integrates directly into popular IDEs, transforming your development environment into an AI-assisted architecture companion. It enables developers to:

•Decompose features into services/components
•Evaluate trade-offs with explicit criteria
•Auto-generate diagrams and documentation

•Apply resilience and security guardrails
•Scaffold Infrastructure-as-Code stubs
•Produce design review checklists

Core Features

Feature Decomposition

Break down features into services with clear interfaces and data flows.

ArchitectureDecompositionServices

Trade-off Evaluation

Compare databases, queues, caches with explicit pros/cons and criteria.

Trade-offsEvaluationDecision Making

Auto-Generated Diagrams

Produce Mermaid diagrams for flowcharts, sequences, and architecture views.

DiagramsMermaidVisualization

ADR Generation

Create and update Architecture Decision Records automatically.

ADRsDocumentationDecisions

Resilience Guardrails

Add retries, backoff, circuit breakers, and SLOs automatically.

ResilienceSLOsCircuit Breakers

Security Scanning

Flag insecure patterns and authentication issues in your architecture.

SecurityScanningGuardrails

IDE Integrations

VS Code

Full extension with command palette, CodeLens, and tree view integration.

VS CodeExtensionFull Support

JetBrains IDEs

Plugin for IntelliJ, WebStorm, PyCharm with similar functionality.

JetBrainsPluginFull Support

Neovim

LSP integration and commands for terminal-based development.

NeovimLSPTerminal

Other IDEs

Universal MCP client support for any IDE with MCP capabilities.

UniversalMCP ClientCompatible

MCP Tools

system.decompose

Breaks down features into services with interfaces and flows.

System DesignDecompositionServices

tradeoffs.evaluate

Compares technologies with pros/cons and explicit criteria.

Trade-offsEvaluationDecision Making

diagram.generate

Produces Mermaid diagrams for various architecture views.

DiagramsMermaidVisualization

adr.create

Generates Architecture Decision Records automatically.

ADRsDocumentationRecords

resilience.recommend

Adds resilience patterns and SLOs to your architecture.

ResilienceSLOsPatterns

iac.scaffold

Creates Infrastructure-as-Code stubs for cloud infrastructure.

IaCInfrastructureCloud

Installation Methods

Local Sidecar (Recommended)

Install as a global npm package and run locally for maximum privacy.

•npm install -g scaling-codes-mcp

•scaling-codes-mcp start

•Configure in your IDE

Hosted MCP

Use our hosted service with authentication and organization defaults.

•Authenticate with PAT/OAuth

•Extension auto-discovers org defaults

•Team-wide configuration

Embedded MCP

Bundled in plugin for one-click onboarding and simplicity.

•Install IDE extension

•MCP server included

•Zero configuration needed

Example Usage

Example: Billing Service Architecture

Your Prompt:

"Design a multi-tenant billing service with Stripe, EU+US residency, p95<200ms."

Generated Outputs:

ADR: docs/adr/ADR-0007-billing-architecture.md
Mermaid diagram: docs/diagrams/billing-seq.mmd
Runbook: ops/runbook/billing.md
IaC scaffold: infra/billing/*

Configuration

Configuration File (.scalingcodes.yml)

service_name: billing
                domain: payments
                defaults:
                  availability: "99.9%"
                  p95_ms: 200
                  residency: ["US", "EU"]
                  data_classification: "PII"
                outputs:
                  adr_dir: docs/adr
                  diagram_dir: docs/diagrams
                  runbook_dir: ops/runbook
                  iac_dir: infra
                guardrails:
                  security_pack: "payments"
                  resilience_pack: "web-services"
                privacy:
                  local_only: true

Security & Privacy

Local-Only Mode

Run the MCP server locally on your machine with no data leaving your environment. Perfect for sensitive projects and enterprise environments.

•No data leaves your machine
•Full control over your data
•Compliant with strict security policies

Enterprise Features

Advanced features for teams and organizations with additional security and compliance requirements.

•Policy packs for different domains
•Audit trails and compliance reporting
•Team collaboration and sharing

Get Started

Ready to transform your IDE?

Install the Scaling Codes MCP server and start building better architectures with AI assistance.