# AXIS Toolbox — Agentic Commerce Codebase Intelligence [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/lastmanupinc-hub/Toolbox  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/axis-toolbox-agentic-commerce-codebase-intelligence

## Description
Generate AGENTS.md, AP2 compliance docs, checkout rules, debug playbook & MCP configs from any repo.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "axis-toolbox-agentic-commerce-codebase-intelligence": {
    "command": "npx",
    "args": ["-y","axis-toolbox-agentic-commerce-codebase-intelligence"]
  }
}
```

## Documentation & README

# Axis' Iliad

> **Axis' Iliad — The modern epic that shapes raw codebases into canonical, agent-ready artifacts. Axis' Iliad authors the definitive foundation for the next era of natural-language workspace development.**

> **Canonical name:** Axis' Iliad. Use this name consistently across docs, registries, and integrations.

[![Tests](https://img.shields.io/badge/tests-4900%2B%20passing-brightgreen)](https://github.com/lastmanupinc-hub/axis-iliad/actions)
[![Coverage](https://img.shields.io/badge/coverage-91.5%25-green)](https://github.com/lastmanupinc-hub/axis-iliad/actions)
[![Website](https://img.shields.io/badge/website-iliad.trustfabric.ai-0ea5e9)](https://iliad.trustfabric.ai)
[![API](https://img.shields.io/badge/API-live-blue)](https://axis-api-6c7z.onrender.com/v1/health)
[![Version](https://img.shields.io/badge/version-0.5.3-blue)](https://github.com/lastmanupinc-hub/axis-iliad/releases)
[![License](https://img.shields.io/badge/license-private-lightgrey)](#license)
[![AXIS-iliad MCP server](https://glama.ai/mcp/servers/lastmanupinc-hub/AXIS-iliad/badges/card.svg)](https://glama.ai/mcp/servers/lastmanupinc-hub/AXIS-iliad)

---

## AXIS Ecosystem

Iliad is the **x402 showcase** in the Trust Fabric stack. Full registry: [`packages/generator-core/src/estate-registry.ts`](https://github.com/lastmanupinc-hub/Toolbox/blob/HEAD/packages/generator-core/src/estate-registry.ts), served live at [`GET /.well-known/axis-estate.json`](https://api.iliad.trustfabric.ai/.well-known/axis-estate.json) (superseding `ecosystem.registry.yaml`, retired 2026-08-22 — see [`docs/ESTATE_FEDERATION_STRATEGY.md`](https://github.com/lastmanupinc-hub/Toolbox/blob/HEAD/docs/ESTATE_FEDERATION_STRATEGY.md)).

| Project | Role | x402 |
|---------|------|------|
| **Axis' Iliad** (this repo) | Agent artifacts + MCP gateway | **Wired** — [`@axis/mpp`](https://github.com/lastmanupinc-hub/Toolbox/blob/HEAD/packages/mpp/README.md) |
| **[PAID](https://paid.trustfabric.ai)** | Multi-rail payments + settlement | Settlement layer (planned Go x402) |
| **[AXIS Foundry](https://github.com/lastmanupinc-hub/AXIS-Foundry)** | 3D pipeline + MCP | Partial |
| **[Trust Fabric](https://trustfabric.ai)** | Compliance audit, remediation + Trust Passport | Planned |

x402 contract: [`docs/x402/CONTRACT.md`](https://github.com/lastmanupinc-hub/Toolbox/blob/HEAD/docs/x402/CONTRACT.md)

---

## Try it in 30 seconds — no signup required

Every program ships free artifacts with no API key — 47 of the 152 in total. Three programs are free in full:

```bash
# 1. Get an API key (free tier, instant)
curl -X POST https://axis-api-6c7z.onrender.com/v1/accounts \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","name":"My Agent","tier":"free"}'

# 2. Analyze any public GitHub repo
curl -X POST https://axis-api-6c7z.onrender.com/v1/github/analyze \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"url":"https://github.com/owner/repo","programs":["search","skills","debug"]}'

# 3. Download the generated artifacts as a ZIP
curl https://axis-api-6c7z.onrender.com/v1/projects/PROJECT_ID/export \
  -H 'Authorization: Bearer YOUR_API_KEY' -o artifacts.zip
```

**Free tier includes:** 47 artifacts spanning all 21 programs — Search (context maps), Skills (AGENTS.md, CLAUDE.md, .cursorrules) and Debug (playbooks, incident templates) in full, plus each other program's headline artifact (design tokens, Dockerfile, MCP config, brand guidelines, ...). Paying unlocks each program's remaining artifacts.

---

## What you get

One scan → 152 artifacts across 21 programs, ready in seconds:

| What you need | Program | Key outputs |
|---------------|---------|-------------|
| Orient a new AI agent | **Search** *(free)* | `context-map.json`, `repo-profile.yaml`, `architecture-summary.md` |
| Give any LLM codebase context | **Skills** *(free)* | `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, `workflow-pack.md` |
| Debug a production incident | **Debug** *(free)* | `debug-playbook.md`, `tracing-rules.md`, `root-cause-checklist.md` |
| Audit your UI | **Frontend** | `frontend-rules.md`, `ui-audit.md`, `component-guidelines.md` |
| Fix search ranking | **SEO** | `seo-rules.md`, `meta-tag-audit.json`, `schema-recommendations.json` |
| Cut LLM costs | **Optimization** | `optimization-rules.md`, `cost-estimate.json`, `token-budget-plan.md` |
| Ship a design system | **Theme** | `design-tokens.json`, `theme.css`, `dark-mode-tokens.json` |
| Unify your brand voice | **Brand** | `brand-guidelines.md`, `voice-and-tone.md`, `messaging-system.yaml` |
| Automate dev workflows | **Superpowers** | `superpower-pack.md`, `workflow-registry.json`, `automation-pipeline.yaml` |
| Launch a campaign | **Marketing** | `campaign-brief.md`, `funnel-map.md`, `ab-test-plan.md` |
| Build data/research tools | **Notebook** | `notebook-summary.md`, `research-threads.md`, `source-map.json` |
| Manage a knowledge vault | **Obsidian** | `obsidian-skill-pack.md`, `vault-rules.md`, `graph-prompt-map.json` |
| Connect AI tools (MCP) | **MCP** | `mcp-config.json`, `mcp-registry-metadata.json`, `protocol-spec.md`, `spec.types.ts`, `mcp/README.md`, `mcp/project-setup.md`, `mcp/build-artifacts.md`, `mcp/package-json.root.template.json`, `mcp/package-json.package.template.json`, `mcp/tsconfig.root.template.json`, `mcp/tsconfig.package.template.json`, `mcp/monorepo-structure.md`, `mcp/core-implementation-artifacts.md`, `mcp/testing-documentation-polish-artifacts.md`, `mcp/fintech-mcp-surface-package.md`, `mcp/fintech-domain-schema.yaml`, `connector-map.yaml`, `capability-registry.json`, `server-manifest.yaml` |
| Generate components | **Artifacts** | `generated-component.tsx`, `dashboard-widget.tsx`, `component-library.json` |
| Create dev videos | **Remotion** | `remotion-script.ts`, `scene-plan.md`, `storyboard.md` |
| Social & visual assets | **Canvas** | `canvas-spec.json`, `social-pack.md`, `poster-layouts.md` |
| Generative art / NFT | **Algorithmic** | `generative-sketch.ts`, `variation-matrix.json`, `parameter-pack.json` |
| Agentic commerce (Visa AP2) | **Agentic Purchasing** | `agent-purchasing-playbook.md`, `checkout-flow.md`, `negotiation-rules.md` |

### Plus the begin loop — hand it to an agent and say `begin`

Every analysis also weaves in a **self-driving control loop** so an AI coding agent can *finish* the work, not just understand it:

- **`begin.yaml`** — the loop head: the inferred goal, a human-in-the-loop protocol (the owner only answers plain-English product questions), the move-selection algorithm, and **convergent stop conditions**.
- **`continuation.yaml`** — the loop state: an ordered step-list of every artifact + a priority **candidate queue** seeded from the analysis (the goal, detected gaps, a verify-harness when no tests exist).
- A **`⟳ Continue` footer** on every Markdown artifact; the final step **self-prompts `begin`**, closing the loop back to `begin.yaml`.

Download the pack (CLI, MCP, or the full-pack export), hand it to an agent, say **`begin`** — it works the queue, verifies each step, and **stops when the queue is empty** (convergent, never a runaway). No coding required on the owner's end.

AXIS dogfoods this on itself: this repo's own root [`begin.yaml`](https://github.com/lastmanupinc-hub/Toolbox/blob/HEAD/begin.yaml) / [`continuation.yaml`](https://github.com/lastmanupinc-hub/Toolbox/blob/HEAD/continuation.yaml) are the live loop we work from, also served verbatim over REST at `GET /begin.yaml` / `GET /continuation.yaml` — so an agent crawling this API discovers the same convention without cloning the repo.

---

## For AI agents — MCP integration

AXIS exposes a **Streamable HTTP MCP server** at `https://axis-api-6c7z.onrender.com/mcp`. Add it to your agent and it can analyze any repo or prepare for agentic purchasing autonomously.

**VS Code** (`.vscode/mcp.json`):
```json
{
  "servers": {
    "axis-iliad": {
      "type": "http",
      "url": "https://axis-api-6c7z.onrender.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

**Claude Desktop** (`claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "axis-iliad": {
      "url": "https://axis-api-6c7z.onrender.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

**Free MCP tools** (no auth needed): `list_programs`, `search_and_discover_tools`, `get_install_manifest`, `discover_agentic_purchasing_needs`, `prepare_agentic_purchasing_preview`, `discover_estate_tools` (sibling AXIS properties — payments, 3D generation, and more), plus the deterministic commerce decision engines: `sca_exemption_decision`, `grade_compliance`, `assemble_ce3_evidence`, `build_ap2_mandate`, `score_dispute_readiness` (evidence-capture readiness — not a dispute-win prediction). Five more are estate-flagged planned-capability stubs (Foundry Wave-1, honest redirects to Foundry's own MCP endpoint until an Iliad-hosted proxy ships): `axis_validate`, `axis_inspect`, `axis_compare`, `axis_manifest_verify`, `roblox_compliance_check`. `get_referral_code`, `get_referral_credits`, and `iliad_network_tokenization` are also free (no charge) but, unlike the tools above, **do require auth**. `ping_payment` is not free — it costs $0.01 and exercises the real x402 payment loop, the cheapest paid call in the catalog.

---

## Pricing

| Tier | Price | Programs |
|------|-------|----------|
| **Free** | $0 | 47 artifacts across all 21 programs (Search, Skills, Debug in full) |
| **Pro** | $3.00 / run | All 21 programs, 152 artifacts |
| **Lite mode** | $0.15–$0.25 / run | Top-gap summary, reduced output |

Budget negotiation: send `X-Agent-Budget: {"budget_per_run_cents": 25}` + `X-Agent-Mode: lite` on any paid call.

---

## Self-host

### System Requirements

- **Node.js**: ≥ 20.x (LTS recommended)
- **pnpm**: ≥ 9.x
- **OS**: macOS 11+, Linux (any distro), or Windows 10+
- **RAM**: 4 GB minimum (8 GB recommended)
- **Disk space**: ~2 GB for dependencies + build

### Quick Start

```bash
# Prerequisites: Node.js ≥ 20, pnpm ≥ 9
git clone https://github.com/lastmanupinc-hub/axis-iliad.git
cd axis-iliad
pnpm install
pnpm build

# Start the API server (port 4000)
node apps/api/dist/server.js

# Start the web UI (port 5173)
cd apps/web && npx vite

# Or use the CLI directly
node apps/cli/dist/cli.js analyze .
node apps/cli/dist/cli.js github https://github.com/owner/repo
```

### Docker

```bash
docker build -t axis-iliad .
docker run -p 4000:4000 axis-iliad
```

Requires: Docker 20.10+ or Docker Desktop

---

## Architecture

```
axis-iliad/
├── apps/
│   ├── api/          → Zero-dependency HTTP server (port 4000, 187 endpoints)
│   ├── cli/          → CLI tool: axis analyze <dir> | axis github <url>
│   └── web/          → Vite + React 19 SPA (dark theme, toast, command palette)
├── packages/
│   ├── snapshots/    → Snapshot intake, Postgres (Neon) persistence, billing, funnel
│   ├── repo-parser/  → Language detection (60+), framework detection (10), import graph
│   ├── context-engine/ → Context map builder, repo profile, route/architecture analysis
│   └── generator-core/ → 152 generators across 21 programs
└── vitest.config.ts  → Shared test config
```

## Programs (21)

| Program | Outputs | Tier |
|---------|---------|------|
| **Search** | context-map.json, repo-profile.yaml, architecture-summary.md, dependency-hotspots.md | Free |
| **Skills** | AGENTS.md, CLAUDE.md, .cursorrules, workflow-pack.md, policy-pack.md | Free |
| **Debug** | debug-playbook.md, incident-template.md, tracing-rules.md, root-cause-checklist.md | Free |
| **Frontend** | frontend-rules.md, component-guidelines.md, layout-patterns.md, ui-audit.md | Pro |
| **SEO** | seo-rules.md, schema-recommendations.json, route-priority-map.md, content-audit.md, meta-tag-audit.json | Pro |
| **Optimization** | optimization-rules.md, prompt-diff-report.md, cost-estimate.json, token-budget-plan.md | Pro |
| **Theme** | design-tokens.json, theme.css, theme-guidelines.md, component-theme-map.json, dark-mode-tokens.json | Pro |
| **Brand** | brand-guidelines.md, voice-and-tone.md, content-constraints.md, messaging-system.yaml, channel-rulebook.md | Pro |
| **Superpowers** | superpower-pack.md, workflow-registry.json, test-generation-rules.md, refactor-checklist.md, automation-pipeline.yaml | Pro |
| **Marketing** | campaign-brief.md, funnel-map.md, sequence-pack.md, cro-playbook.md, ab-test-plan.md | Pro |
| **Notebook** | notebook-summary.md, source-map.json, study-brief.md, research-threads.md, citation-index.json | Pro |
| **Obsidian** | obsidian-skill-pack.md, vault-rules.md, graph-prompt-map.json, linking-policy.md, template-pack.md | Pro |
| **MCP** | mcp-config.json, mcp-registry-metadata.json, protocol-spec.md, connector-map.yaml, capability-registry.json, server-manifest.yaml | Pro |
| **Artifacts** | generated-component.tsx, dashboard-widget.tsx, embed-snippet.ts, artifact-spec.md, component-library.json | Pro |
| **Remotion** | remotion-script.ts, scene-plan.md, render-config.json, asset-checklist.md, storyboard.md | Pro |
| **Canvas** | canvas-spec.json, social-pack.md, poster-layouts.md, asset-guidelines.md, brand-board.md | Pro |
| **Algorithmic** | generative-sketch.ts, parameter-pack.json, collection-map.md, export-manifest.yaml, variation-matrix.json | Pro |
| **Agentic Purchasing** | agent-purchasing-playbook.md, product-schema.json, checkout-flow.md, negotiation-rules.md, commerce-registry.json | Pro |
| **Closer** | packaging/README.md, Dockerfile, .github/workflows/ci.yml, packaging-report.md, DISTRIBUTABLE.md, Makefile | Pro |
| **Deploy** | deploy/Dockerfile, deploy/render.yaml, deploy/deploy.sh, deploy/worker.ts, deploy-qualification-report.md | Pro |

## API Endpoints

### Core Pipeline
| Method | Path | Description |
|--------|------|-------------|
| POST | `/v1/snapshots` | Upload repo snapshot (multipart file upload) |
| POST | `/v1/github/analyze` | Analyze repo from GitHub URL |
| GET | `/v1/snapshots/:id` | Get snapshot metadata |
| GET | `/v1/projects/:project_id/snapshots` | List snapshots for project |
| POST | `/v1/search/export` | Run search program |
| POST | `/v1/skills/generate` | Run skills program |
| POST | `/v1/debug/analyze` | Run debug program |
| POST | `/v1/frontend/audit` | Run frontend program |
| POST | `/v1/seo/analyze` | Run SEO program |
| POST | `/v1/optimization/analyze` | Run optimization program |
| POST | `/v1/theme/generate` | Run theme program |
| POST | `/v1/brand/generate` | Run brand program |
| POST | `/v1/superpowers/generate` | Run superpowers program |
| POST | `/v1/marketing/generate` | Run marketing program |
| POST | `/v1/notebook/generate` | Run notebook program |
| POST | `/v1/obsidian/analyze` | Run obsidian program |
| POST | `/v1/mcp/provision` | Run MCP program |
| POST | `/v1/artifacts/generate` | Run artifacts program |
| POST | `/v1/remotion/generate` | Run remotion program |
| POST | `/v1/canvas/generate` | Run canvas program |
| POST | `/v1/algorithmic/generate` | Run algorithmic program |
| POST | `/v1/agentic-purchasing/generate` | Run agentic purchasing program |
| GET | `/v1/programs` | List all programs with generator counts |
| GET | `/v1/projects/:id/generated-files/:path` | Download individual generated file |
| GET | `/v1/projects/:id/export` | Download ZIP of generated files |

### Billing & Account
| Method | Path | Description |
|--------|------|-------------|
| POST | `/v1/accounts` | Create account |
| GET | `/v1/account` | Get account info |
| POST | `/v1/account/keys` | Create API key |
| GET | `/v1/account/keys` | List API keys |
| POST | `/v1/account/keys/:id/revoke` | Revoke API key |
| GET | `/v1/account/usage` | Get usage stats |
| GET | `/v1/account/quota` | Get quota info |
| POST | `/v1/account/tier` | Update billing tier |
| POST | `/v1/account/programs` | Update program entitlements |
| POST | `/v1/account/github-token` | Save encrypted GitHub token |
| GET | `/v1/account/github-token` | List GitHub tokens |
| DELETE | `/v1/account/github-token/:token_id` | Delete GitHub token |
| GET | `/v1/billing/history` | Billing tier change audit trail |
| GET | `/v1/billing/proration` | Proration preview for tier changes |

### Funnel & Plans
| Method | Path | Description |
|--------|------|-------------|
| GET | `/v1/plans` | Get plan catalog |
| POST | `/v1/account/seats` | Invite team member |
| GET | `/v1/account/seats` | List team seats |
| POST | `/v1/account/seats/:id/revoke` | Revoke seat |
| GET | `/v1/account/upgrade-prompts` | Get contextual upgrade prompts |
| GET | `/v1/account/funnel-status` | Get funnel stage |
| GET | `/v1/admin/funnel-metrics` | Aggregate funnel analytics |

### Search & Versions
| Method | Path | Description |
|--------|------|-------------|
| POST | `/v1/search/index` | Index snapshot content for full-text search |
| POST | `/v1/search/query` | Full-text search across indexed content |
| GET | `/v1/search/:id/stats` | Search index statistics |
| GET | `/v1/snapshots/:id/versions` | List generation versions |
| GET | `/v1/snapshots/:id/versions/:num` | Get specific version with files |
| GET | `/v1/snapshots/:id/diff?old=N&new=M` | Diff between two versions |

### Webhooks
| Method | Path | Description |
|--------|------|-------------|
| POST | `/v1/account/webhooks` | Create webhook |
| GET | `/v1/account/webhooks` | List webhooks |
| DELETE | `/v1/account/webhooks/:id` | Delete webhook |
| POST | `/v1/account/webhooks/:id/toggle` | Toggle webhook active/disabled |
| GET | `/v1/account/webhooks/:id/deliveries` | List delivery attempts |

### Infrastructure
| Method | Path | Description |
|--------|------|-------------|
| GET | `/v1/health` | Health check |
| GET | `/v1/health/live` | Liveness probe |
| GET | `/v1/health/ready` | Readiness probe (DB connectivity) |
| GET | `/v1/metrics` | Prometheus-style metrics |
| GET | `/v1/db/stats` | Database statistics |
| POST | `/v1/db/maintenance` | Database maintenance (vacuum, WAL checkpoint) |
| GET | `/v1/docs` | OpenAPI 3.1 specification |
| GET | `/v1/admin/stats` | System-wide statistics |
| GET | `/v1/admin/accounts` | Admin: list all accounts |
| GET | `/v1/admin/activity` | Admin: recent activity feed |

## Input Methods

1. **File Upload** — POST `/v1/snapshots` with multipart body
2. **GitHub URL** — POST `/v1/github/analyze` with `{ "url": "https://github.com/..." }`
3. **CLI (local)** — `axis analyze <directory>` scans local files
4. **CLI (remote)** — `axis github <url>` fetches from GitHub

## Tech Stack

- **Runtime**: Node.js 20+, TypeScript 5.7 strict
- **Backend**: Zero-dependency custom HTTP router, Neon Postgres (`pg`, async pooled)
- **Frontend**: Vite 6 + React 19, CSS design system (dark theme)
- **Testing**: Vitest 4 — ~4,900 tests across ~190 files, run against Postgres 16
- **Benchmarks**: Vitest bench harness (`packages/repo-parser/src/perf.bench.ts`, `npx vitest bench`) covers `parseRepo` at 200-file scale; no specific latency number is pinned here — this repo's own honesty policy (see `packages/generator-core/src/perf-compliance.test.ts`) bans citing a perf figure unless it's sourced from a checked-in, machine-generated results file, which doesn't yet exist for this bench. The 7 agentic-purchasing engines DO have one: `packages/generator-core/perf-results.json` (regenerate via `pnpm bench:compliance`).
- **Build**: pnpm workspaces, tsc per package
- **CI**: GitHub Actions (Node 20/22 matrix, coverage, dep audit, Docker build)

## Development

```bash
pnpm install          # Install all dependencies
pnpm build            # Build all packages + apps
pnpm test             # Run all tests
npx vitest run        # Run tests directly
npx vitest bench      # Run performance benchmarks
npx vitest --coverage # Run tests with coverage report
```

See [CONTRIBUTING.md](https://github.com/lastmanupinc-hub/Toolbox/blob/HEAD/CONTRIBUTING.md) for how to add a generator, endpoint, or program.

## Input methods

| Method | How |
|--------|-----|
| GitHub URL | `POST /v1/github/analyze` with `{"url":"https://github.com/..."}` |
| File upload | `POST /v1/snapshots` multipart body |
| CLI (local) | `axis analyze <directory>` |
| CLI (remote) | `axis github <url>` |
| MCP | `tools/call` → `analyze_repo` or `analyze_files` |

---

**Website**: `https://iliad.trustfabric.ai` · **Live API**: `https://axis-api-6c7z.onrender.com` · **Docs**: `https://axis-api-6c7z.onrender.com/v1/docs` · **MCP**: `https://axis-api-6c7z.onrender.com/mcp`

## License

Private. All rights reserved.