io.factorguide/factorguide
Send a coupling matrix, get zone classifications and optimal factorization strategy.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http factorguide 'https://factorguide.io/mcp'
{
"mcpServers": {
"factorguide": {
"type": "http",
"url": "https://factorguide.io/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
FactorGuide
Decision intelligence for AI agents. Send a coupling matrix — get zone classifications, optimal factorization strategy, and calibrated risk predictions.
Every system with interacting variables has a coupling structure. When an agent simplifies that system by treating variables as independent, it pays an information cost. FactorGuide quantifies that cost exactly.
Quick Start
MCP (Model Context Protocol)
FactorGuide is listed on the Official MCP Registry. Any MCP-compatible agent discovers tools automatically:
mcp_endpoint: https://factorguide.io/mcp
HTTP REST
POST https://factorguide.io/navigate
POST https://factorguide.io/diagnose
POST https://factorguide.io/explain
POST https://factorguide.io/report_outcome
Agent Discovery
GET https://factorguide.io/llms.txt
GET https://factorguide.io/openapi.json
Example
Send a 3×3 correlation matrix:
{
"coupling": {
"covariance_matrix": [
[1.00, 0.72, 0.05],
[0.72, 1.00, 0.48],
[0.05, 0.48, 1.00]
]
},
"sample_size": 500,
"model_class": "constitutive"
}
Get back zone classifications:
| Pair | IC | Zone | Recommendation |
|---|---|---|---|
| z0–z1 | 0.682 | 3 | PRESERVE |
| z0–z2 | 0.031 | 1 | FACTORIZE |
| z1–z2 | 0.453 | 2 | ASSESS |
- Zone 1: Safe to factorize. Coupling below threshold.
- Zone 2: Depends on functional role. Same IC, opposite recommendations for constitutive vs. inductive coupling.
- Zone 3: Must preserve. Coupling is load-bearing regardless of model class.
Pricing
| Tier | Price | Queries | Max Variables |
|---|---|---|---|
| Trial | Free | 15 per wallet | n ≤ 25 |
| Starter | $0.05/query | 50–200 bundles | n ≤ 100 |
| Professional | $0.03/query | 500–2000 bundles | n ≤ 1000 |
Payment: USDC on Base via x402 or MPP. report_outcome is always free.
Data Privacy
FactorGuide accepts only second-order summary statistics — covariance, precision, correlation matrices, or edge lists. No raw observations. Matrices are zeroed after IC computation.
Theoretical Foundation
Built on Circulatory Fidelity, a mathematical framework where IC (Inference Coupling) measures the partial correlation between variables. The cost function V(IC) gives the exact mutual information destroyed by severing a coupling. Risk curves are calibrated on 49,000+ validated datapoints.
Every prediction is falsifiable. When agents report outcomes, the flywheel refines future predictions.
Links
- Website: factorguide.io
- Theory: circulatoryfidelity.com
- MCP Registry: registry.modelcontextprotocol.io
Built by CF Laboratory
Frequently asked questions
What is io.factorguide/factorguide?
Send a coupling matrix, get zone classifications and optimal factorization strategy.
How do I install io.factorguide/factorguide?
It runs as a remote server. In Claude Code: claude mcp add --transport http factorguide 'https://factorguide.io/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.factorguide/factorguide need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.factorguide/factorguide open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains io.factorguide/factorguide?
It is published by Bwana7. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.