Factorguide
Classify coupling zones from a matrix and choose a modularization or factorization plan before splitting a monolith or microservices boundary.
Overview
io.factorguide/factorguide is an MCP server for the Build phase that classifies coupling-matrix zones and suggests an optimal factorization strategy.
What is this MCP server?
- Accepts a coupling matrix and returns zone classifications for modules or components
- Recommends an optimal factorization or modularization strategy from the matrix
- Remote streamable-http endpoint at factorguide.io/mcp (v1.2.1)
- Useful when agents help refactor monoliths or plan package and service splits
- Remote MCP version 1.2.1
- Transport: streamable-http at factorguide.io/mcp
- Source repository: github.com/Bwana7/factorguide
What problem does it solve?
You have a tangled codebase but no objective read on which modules are tightly coupled or how to split them without breaking everything.
Who is it for?
Indie builders refactoring Node, Python, or polyglot backends who want matrix-driven boundary advice inside the agent chat.
Skip if: Teams that need automatic code moves, CI enforcement, or security scanning without supplying their own coupling matrix.
What do I get? / Deliverables
Your agent returns zone labels and a factorization strategy you can turn into an incremental modularization or service-extraction plan.
- Zone classifications for matrix entries
- Recommended factorization or modularization strategy narrative
Recommended MCP Servers
Journey fit
Canonical shelf is Build because the server answers architecture and decomposition questions while you are still shaping backend structure, not after launch ops. Backend is the best fit: coupling matrices and factorization strategies target service boundaries, modules, and dependency graphs in the codebase.
How it compares
Architecture matrix advisor via MCP, not a static-analysis CLI that scans the repo for you.
Common Questions / FAQ
Who is io.factorguide/factorguide for?
Solo builders and tech leads using AI coding agents who need structured modularization guidance from a coupling matrix.
When should I use io.factorguide/factorguide?
Use it during backend design or refactor planning when you have or can generate a coupling matrix and want zone classifications plus a split strategy.
How do I add io.factorguide/factorguide to my agent?
Register the remote MCP URL https://factorguide.io/mcp as streamable-http in your client’s MCP config (Claude Code, Cursor, etc.) per your tool’s remote server docs.