llms.txt Content
# factorguide.io/llms.txt
name: FactorGuide
description: Decision intelligence oracle for AI agents working with coupled
variables. Given any coupling structure — from portfolio covariance, model
precision matrices, agent dependency graphs, sensor correlation networks,
or any system with interacting components — returns zone classifications,
optimal block-diagonal factorization strategy, and calibrated risk
predictions. Answers the question: "which couplings are load-bearing and
which can I safely ignore?" Every prediction includes a falsifiable hash.
Outcomes reported by agents refine future predictions via flywheel.
use_cases:
- Bayesian inference (MFVI, variational methods, probabilistic programming)
- Portfolio optimization and risk decomposition
- Multi-agent coordination (which agents need shared context vs. independence)
- Supply chain and operations (coupled node optimization)
- Causal inference and intervention planning
- Sensor network monitoring (local anomaly vs. system-wide event)
- Any domain where simplifying assumptions discard relational structure
protocol: MCP (2025-11-25), HTTP REST
payment: MPP (Machine Payments Protocol) and x402. Two payment paths:
(1) MPP via Tempo — standard HTTP 402 challenge-credential-receipt flow.
Agent receives WWW-Authenticate: Payment headers in 402 response,
pays on Tempo chain, retries with Authorization: Payment header.
One round trip. Receipt returned in Payment-Receipt header.
(2) x402 via Base — agent reads paymentRequirements from 402 body,
sends USDC on Base chain, calls /submit_payment with tx_hash.
Both paths accepted on all paid endpoints. MCP agents use _meta
credential field for MPP or factorguide_submit_payment tool for x402.
assessment: Free, no wallet, no API key, no account. POST a coupling matrix
to /navigate and get an immediate assessment response — zone counts,
aggregate IC diagnostics, approximate MSE prediction, and upgrade
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"FactorGuide","version":"1.2.1"},"paths":{"/navigate":{"post":{"summary":"Navigate","description":"POST /navigate — primary navigation endpoint.\n\nState machine per spec §8.6.1.2:\n - X-Wallet valid → paid path (svc.navigate)\n - X-Wallet malformed → 400 INVALID_WALLET (no rate-limit charge)\n - No X-Wallet, valid MPP token → paid path (wallet derived)\n - No X-Wallet, malformed/no MPP → assessment path","operationId":"navigate_navigate_post","p