<div align="center">

<img src="assets/codinfy-brand/ICON.png" alt="Codix Build" width="96" />

# `@codinfy/codix-build-mcp`

### Build faster with AI agents — Codix Build MCP

Build **websites, mobile apps, SaaS, scripts and software faster** with AI agents while **reducing token usage** via Smart Context Mode. Works with Claude Code, Codex, Cursor, Continue, Cline, Windsurf.

[![npm version](https://img.shields.io/npm/v/@codinfy/codix-build-mcp.svg?color=FF7900)](https://www.npmjs.com/package/@codinfy/codix-build-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-34BB78.svg)](LICENSE)
[![Node](https://img.shields.io/badge/node-%E2%89%A518-339933?logo=node.js&logoColor=white)](https://nodejs.org)
[![MCP](https://img.shields.io/badge/Model_Context_Protocol-compatible-2563EB)](https://modelcontextprotocol.io)

**📦 [npm](https://www.npmjs.com/package/@codinfy/codix-build-mcp) · 🌐 [codinfy.com](https://codinfy.com) · 📚 [docs.codinfy.com/codix-build-mcp](https://docs.codinfy.com/codix-build-mcp) · 🛡️ [Security](SECURITY.md)**

**🇬🇧 English** · [🇫🇷 Français](README.fr.md)

</div>

---

## Status

> **v0.1.0 — AGENT-46 public release.** Ships 16 local `codix.*` tools, Smart Context Mode, templates, prompt packs, skill packs, client examples and docs.
> Track docs at [`docs.codinfy.com/codix-build-mcp`](https://docs.codinfy.com/codix-build-mcp).

---

## Why Codix Build MCP?

When you ask an AI agent to "build a Laravel SaaS with licences, payments and a mobile-first dashboard", you usually end up:

1. pasting hundreds of lines of architecture guidance into every prompt;
2. burning tokens re-explaining the same stack decisions to every new agent;
3. ending up with inconsistent code across modules;
4. struggling to switch from Cursor → Claude Code → Codex without losing context.

Codix Build MCP fixes all four problems by exposing a small set of MCP tools that:

- **Analyse** a project description and pick a sensible stack.
- **Recommend** templates, prompt packs and skill packs that match your goal.
- **Inject context efficiently** (Smart Context Mode) so you never pay for tokens twice.
- **Generate** scaffolds (Laravel, Next.js, Flutter, WordPress, SaaS, Marketplace, API) with license, design, and deployment helpers wired in.

It is built and maintained by the Codinfy team, the same team that ships [`@codinfy/mcp`](https://github.com/bakalagoin/codinfy-mcp) (Codinfy public API MCP).

---

## Install

```bash
npm install -g @codinfy/codix-build-mcp
# or
npx -y @codinfy/codix-build-mcp
```

## Configure your agent

### Claude Code / Claude Desktop

`~/.claude/mcp.json`:

```json
{
  "mcpServers": {
    "codix-build": {
      "command": "npx",
      "args": ["-y", "@codinfy/codix-build-mcp"]
    }
  }
}
```

### Cursor / Codex / Continue / Windsurf / GitHub Copilot-compatible clients

See [`examples/`](examples) and [`docs/getting-started.md`](docs/getting-started.md).

### Authenticated mode

v0.1.0 works fully in public local mode. `CODIX_BUILD_API_KEY` is reserved for future public quotas:

```json
"env": { "CODIX_BUILD_API_KEY": "pk_live_xxxxxxxxxxxxxxxxx" }
```

Without a key, the MCP runs in public mode and never calls internal Codinfy services.

---

## Tools (16)

### Analyse & plan
- `codix.project.analyze` — turn a short brief into a structured project spec
- `codix.stack.recommend` — pick a stack from your constraints (hosting, budget, team)
- `codix.architecture.get` — fetch the canonical architecture for a stack
- `codix.context.smart` — Smart Context Mode (only sends the chunks the agent actually needs)

### Generate
- `codix.prompt.generate` — turn the project spec into prompt packs for any agent
- `codix.template.get` — fetch a project template (Laravel, Next.js, Flutter, etc.)
- `codix.license.inject` — wire a license validation client (Codinfy or generic)
- `codix.design.apply` — apply a design token system (Tailwind 4 `@theme`, brand palette)
- `codix.api.generate` — REST or GraphQL spec from the project model
- `codix.database.schema` — migrations + seeders for MariaDB/MySQL/PostgreSQL

### Quality & ops
- `codix.security.checklist` — OWASP top 10 + secrets + auth review
- `codix.marketplace.check` — readiness check for CodeCanyon / Codinfy marketplace
- `codix.docs.generate` — README + CONTRIBUTING + DEPLOYMENT in one shot
- `codix.deploy.guide` — cPanel, Vercel, Render, Fly.io, Cloudflare Pages, or bare VPS
- `codix.debug.help` — interactive debugging hints for the current stack
- `codix.cost.optimize` — flag expensive patterns (token-burning prompts, N+1, fat assets)

Schemas, parameters, examples and changelogs live in [`docs/`](docs) and at [`docs.codinfy.com/codix-build-mcp`](https://docs.codinfy.com/codix-build-mcp).

---

## What ships in the package

```
codix-build-mcp/
├── src/
│   ├── index.ts              # MCP server bootstrap
│   ├── tools.ts              # MCP tool registry
│   ├── engine.ts             # local deterministic planning engine
│   └── config.ts             # public runtime config
├── templates/                # project templates
│   ├── laravel/
│   ├── nextjs/
│   ├── flutter/
│   ├── wordpress/
│   ├── saas/
│   ├── marketplace/
│   └── api/
├── prompt-packs/             # reusable prompt packs
│   ├── token-saver/
│   ├── license/
│   ├── marketplace/
│   ├── cpanel/
│   └── deploy/
├── skill-packs/              # markdown skill briefings
│   ├── architecture/
│   ├── security/
│   ├── docs/
│   └── business-kit/
├── examples/                 # MCP-client configs
│   ├── claude-code.json
│   ├── codex.json
│   ├── cursor.json
│   ├── github-copilot.json
│   └── windsurf.json
├── docs/                     # getting-started, tool reference, FAQ, changelog
├── package.json
├── tsconfig.json
└── .github/workflows/        # ci.yml + publish-npm.yml
```

---

## Companion projects

| Repo | Purpose | License |
|---|---|---|
| [`codinfy-mcp`](https://github.com/bakalagoin/codinfy-mcp) | Public MCP to call Codinfy APIs (licenses, payments, brand) | MIT |
| [`codix-build-mcp`](https://github.com/bakalagoin/codix-build-mcp) (this) | Build any project faster, with Smart Context Mode | MIT |
| `codinfy-mcp-internal` | Private MCP for the Codinfy team | proprietary |

---

## Releases

Pushing a tag `v*` to `main` publishes to npm automatically.

```bash
npm version patch
git push --follow-tags
```

---

## Security

Report vulnerabilities privately to **security@codinfy.com**. See [`SECURITY.md`](SECURITY.md).

## Contributing

Issues and PRs welcome. See [`CONTRIBUTING.md`](CONTRIBUTING.md).

## 🌍 Connect with us

| Network | Codinfy | Bakala Goin (Founder & CEO) |
|---|---|---|
| **Facebook** | [@codinfyci](https://facebook.com/codinfyci) | [@bakalagoin](https://facebook.com/bakalagoin) |
| **Instagram** | [@codinfyci](https://instagram.com/codinfyci) | [@bakalagoin](https://instagram.com/bakalagoin) |
| **LinkedIn** | [company/codinfyen](https://linkedin.com/company/codinfyen/) | [bakala-goin](https://www.linkedin.com/in/bakala-goin-66428b247) |
| **TikTok** | — | [@bakalagoin](https://www.tiktok.com/@bakalagoin) |
| **X (Twitter)** | — | [@bakalagoin](https://twitter.com/bakalagoin) |

## License

[MIT](LICENSE) © 2026 **RAFLOX SAS** — Abidjan, Côte d'Ivoire.

---

<div align="center">

**Codinfy** — by **RAFLOX SAS** · 📧 [contact@codinfy.com](mailto:contact@codinfy.com) · 🌐 [codinfy.com](https://codinfy.com)

<sub>Part of the Codinfy MCP ecosystem · <a href="https://github.com/bakalagoin/codinfy-mcp">codinfy-mcp</a></sub>

</div>