madcatalog docs

Internal documentation — architecture decisions, proposal, and prototype.

Business Model

MRR projections, cost structure, funnel analysis, and investor-ready financial framing.

View Business Model →

Architecture Decisions

Lightweight ADRs covering every key design choice from UI framework to business model.

Browse ADRs →

Proposal

Full implementation proposal for the madcatalog × MPP integration, including future business opportunities.

Open Proposal →

Prototype

Interactive catalog mockup and advertiser profile pages built during the prototype phase.

View Prototype →

Architecture

Source-driven structural diagrams of the Go MCP server and Node.js Lambdas, regenerated from code so they can't drift.

View Diagrams →

Calculations Appendix

All business (ranking, spend, pricing) and operational (latency, revenue, error rate) calculations, schema-validated at runtime.

View Calculations →

AWS Production Plan

Production readiness audit, Grafana dashboard assessment, and a cheap AWS deployment plan — under $1/month.

View Plan →

MCP Usage & Deployment

How AI agents connect, the 12 tools, typical agent workflows, auth gaps, and production deployment options.

View Sketch →