# Evolved

> Free & open-source business operating system anyone can stand up for their own company - four surfaces, one brain: an MCP (84 tools), a crew field app, a Google Sheets workbook + router, and an owner dashboard. Any trade in one call. A real Alberta company runs on it. OKX.AI ASP (A2MCP + opt-in x402), X Layer testnet. MIT.

- **Type:** MCP server
- **Install:** `agentstack add mcp-kr8tiv-ai-evolved`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kr8tiv-ai](https://agentstack.voostack.com/s/kr8tiv-ai)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kr8tiv-ai](https://github.com/kr8tiv-ai)
- **Source:** https://github.com/kr8tiv-ai/evolved
- **Website:** https://www.evolvedmcp.cloud

## Install

```sh
agentstack add mcp-kr8tiv-ai-evolved
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

### Most AI talks about business. Evolved runs one.

One agent takes **any** service business from a texted photo to a paid, on-chain invoice. **Free, open source (MIT), and adaptable to any trade in one call** — proven on a real Alberta company. 84 tools, live as an MCP service, with on-chain settlement on OKX X Layer testnet.

> **A complete business operating system — free, open source, for *any* company.** Not just an MCP server: four surfaces around one source of truth — the **MCP brain**, the **crew field app** (its hands), the **workbook spine**, and the **owner dashboard** (its eyes). Blasting is only the proving ground; `franchise_spinup` makes it any service business in one call. Pick your trade, generate your workbook, connect the app: **[docs/ONBOARDING.md](docs/ONBOARDING.md)**.

**▶ [TRY IT LIVE — the browser playground](https://www.evolvedmcp.cloud/)** — no install, no keys: run voice commands, photo-quote a driveway, drive the autonomous lifecycle through its two human money gates, and watch the x402 402 → proof → receipt flow, all against the real endpoint.

**🎬 The 90-second film** — every figure captured live from the endpoint ([notes + license](submission/DEMO-VIDEO.md)):

https://github.com/user-attachments/assets/ca858ecb-cf70-40d5-a1ac-54efef74f971

▶ Plays inline right here · also streaming at [www.evolvedmcp.cloud/demo.mp4](https://www.evolvedmcp.cloud/demo.mp4) · [full-quality file](submission/evolved-demo.mp4)

[](https://modelcontextprotocol.io)
[](https://www.okx.ai)
[](https://web3.okx.com/xlayer)
[](https://www.evolvedmcp.cloud/health)
[](docs/TOOLS.md)
[](#every-claim-is-tested)
[](LICENSE)

[Judge tour](#the-60-second-judge-tour) · [Why this wins](#why-this-wins) · [The lifecycle](#watch-one-agent-run-the-whole-engagement) · [On-chain](#paid-on-chain-okx-x-layer) · [Frontier](#the-frontier-set) · [84 tools](#the-tool-surface--84-tools-16-domains) · [Docs](docs/)

---

## Quick start — running in about 2 minutes

**Try it now, nothing to install:** open the live playground at **[www.evolvedmcp.cloud](https://www.evolvedmcp.cloud/)** and click Judge Mode.

**Run the MCP yourself** *(prerequisites: Node 20+ and git — nothing else, no keys, no accounts):*

```bash
git clone https://github.com/kr8tiv-ai/evolved.git && cd evolved
npm install && npm run build && npm run demo   # the business loop, narrated
```

**Wire it into your agent** — hosted (nothing to install) via the `mcp-remote` bridge:

```json
{ "mcpServers": { "evolved": { "command": "npx", "args": ["-y", "mcp-remote", "https://www.evolvedmcp.cloud/mcp"] } } }
```

Then ask it: *"Run the morning digest — what am I about to drop?"* Full client configs (Claude Desktop, Cursor, local stdio): [docs/CONNECT.md](docs/CONNECT.md). Make it **your** business in one call, then stand up the whole system (workbook, field app, dashboard): **[docs/STAND-UP-YOUR-OWN.md](docs/STAND-UP-YOUR-OWN.md)** — an afternoon for the MCP + workbook, a weekend for all four surfaces.

## The 60-second judge tour

The service is live. You can verify every headline claim from your terminal before reading another word.

```bash
# 1 · It exists, and it is an MCP service (10 seconds)
curl https://www.evolvedmcp.cloud/health

# 2 · It monetizes as an ASP — x402 pay-per-call (the 402 challenge, scheme "exact", eip155:1952)
curl -i -X POST https://www.evolvedmcp.cloud/mcp-paid \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"judge","version":"1"}}}'

# 3 · Pay the challenge, get the service (settlement receipt in the X-PAYMENT-RESPONSE header)
#     (header is base64 of {"simulated":true} — quote-safe on every shell, incl. PowerShell)
curl -i -X POST https://www.evolvedmcp.cloud/mcp-paid \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H 'X-PAYMENT: eyJzaW11bGF0ZWQiOnRydWV9' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"judge","version":"1"}}}'

# 4 · The revenue scoreboard (paid calls + settlements, survives demo resets)
curl https://www.evolvedmcp.cloud/stats
```

Then run the whole company locally — no keys, no accounts, no funds:

```bash
git clone https://github.com/kr8tiv-ai/evolved.git && cd evolved
npm install && npm run build
npm test        # 48 tests — including a LIVE X Layer testnet probe
npm run demo    # the business loop, narrated in your terminal
```

## Why this wins

**Every "AI for business" demo is a chatbot wearing a suit. Evolved is a complete company operating system any service business can spin up in one call — and it is built from the operating system of a real one.** `franchise_spinup { tradePack: "pressure-washing" }` hands the whole machine to another trade in seconds; the credibility comes from Evolve Eco Blasting, the working Alberta abrasive-blasting company whose rates, GST and deposit policy, safety practice, and ball-drop rules run the demo — reimplemented, extended, and tested here. The demo dataset is synthetic; the math is not, and neither is the trade.

- **Any business, in one call.** `franchise_spinup` re-seeds the whole OS for a new trade with its own rate card, hazards, pricing unit (sqft / hour / unit / vehicle / flat), currency, and tax label (GST / VAT / Sales Tax) — a US or EU shop never touches the code. Proven on blasting; built for everyone.
- **Both OKX rails — and the paid one is opt-in.** Customer invoices settle in OKB on X Layer via EIP-681 requests verified by read-only RPC. The x402 pay-per-call tier is a **built-in rail any adopter can switch on** for their own deployment — off by default, never gating the free system. The on-chain integration judges score, without a toll on the open promise.
- **Autonomy with judgment.** One agent runs lead → e-sign → weather-gated booking → FLHA safety → books → invoice → on-chain settlement → review — and holds at exactly two human gates, both about money. Agentic where it should be, accountable where it must be.
- **It learns — and never stops.** Won jobs teach the rate engine (driveways converged to ~$9/sqft from outcome history), and every logged outcome now lifts a live **confidence** score and tightens the suggested quote range — more data, sharper quotes, on real or synthetic history alike. Each learned rate is **benchmarked against the market band** it derives from the trade's own card (`market_benchmark`, `pricing_learning_status`), so a quote is never blind; the books re-audit themselves daily; insight rankings train on the owner's feedback.
- **It is hardened, not vibed.** A documented adversarial review pass produced 29 confirmed findings — including on-chain replay protection and e-sign decline finality — every one fixed and regression-tested in [`f6acd80`](https://github.com/kr8tiv-ai/evolved/commit/f6acd80). A second security pass followed: the replay claim is now **atomic under concurrency** (a test drives the race), the rate limiter resolves the client IP through trusted-proxy hops instead of a spoofable header, `workbook_create` link-shares **read-only** by default, and the two dataset-replacing tools are fenced off the shared public endpoint. 48 tests pass, one live against X Layer testnet. Full model: [SECURITY.md](SECURITY.md).
- **Your books live in a real workbook.** The whole OS renders as an operations workbook — every collection a tab. `workbook_create` builds and syncs an actual **Google Sheets** workbook (service-account JWT, no SDK, no keys stored); `workbook_export` writes the identical 20 tabs as CSV with zero credentials. The spine the production company runs on, available to every adapted business.
- **It scales past one company.** `franchise_spinup` re-seeds the entire OS for any trade with a custom rate card in one call — `franchise_preview` window-shops it safely, `brand_configure` makes the rendered quotes feel like *your* company. Business management in a box is the product, not the tagline.

## One complete system — four surfaces, one brain

Evolved isn't just an MCP server — it's a complete, free, open-source operating system **any** service business can run, with four surfaces around a single source of truth:

- 🧠 **The MCP — the brain** *(this repo).* 84 tools that hold the business logic: pricing, safety, books, dispatch, on-chain settlement. Every other surface is a client of it. Clone, `npm install`, `npm run build`, zero credentials.
- ✋ **The field app — the crew's hands** — [kr8tiv-ai/evolve-field-app](https://github.com/kr8tiv-ai/evolve-field-app) (MIT). A worker taps one button in the truck — photo, receipt, FLHA sign-off, hazard, note — and it lands in the App Inbox for the brain to file. $0/month on Google Apps Script. Deployed and in daily production use, which is what makes the tool surface a description of real work rather than a design exercise. Everything queues except safety: `hazard_report` escalates immediately, and an uncleared **stop-work** outranks every money flag on the dispatch board. ([how it plugs in](docs/FIELD-APP.md))
- 📊 **The workbook — the spine** — the whole operation as a 20-tab Google Sheets workbook, created and synced by `workbook_create` or exported to CSV with zero credentials. One shared source of truth for the humans and the agent. ([generate your own](docs/ONBOARDING.md))
- 📈 **The dashboard — the owner's eyes.** A login-protected, mobile-responsive web app reading the same workbook — **live at [ops.evolveecoblasting.com](https://ops.evolveecoblasting.com)** (behind auth), source open-sourcing to `kr8tiv-ai/evolve-dashboard` (MIT): a finance dashboard with interactive charts (spend proportion, revenue and margin trends, job-profitability comparison); job P&Ls, quotes, invoices, and receivables with every entity clickable through to its document; filterable receipts with pop-up images; an insights page (last month's revenue, where the money went, margin trends, outstanding receivables); a safety page (FLHAs, mitigations, worker sign-offs — audit-ready); a maintenance page (servicing, wear items, overdue work); and a company inventory page tied to a materials price tracker. Same dark aurora branding. Read-only onto the spine — it shows, the brain does. ([how it plugs in](docs/DASHBOARD.md))

```mermaid
%%{init: {"theme": "dark", "themeVariables": {"primaryColor": "#101010", "primaryBorderColor": "#4ade80", "primaryTextColor": "#f3f4f6", "lineColor": "#4ade80", "fontFamily": "Segoe UI"}}}%%
flowchart LR
    FA["✋ Field appcrew's hands"] --> INBOX["App Inbox"]
    INBOX --> MCP["🧠 Evolved MCPthe brain · 84 tools"]
    MCP --> WB["📊 Workbook spineGoogle Sheets · 20 tabs"]
    MCP --> CHAIN["⛓ On-chain settlementX Layer testnet"]
    WB -.->|source of truth| MCP
    WB --> DASH["📈 Owner dashboardthe owner's eyes"]
```

**Stand up the whole thing for your own company** — your workbook, your router, your field app, your dashboard, your MCP, nothing of Evolve's: **[docs/STAND-UP-YOUR-OWN.md](docs/STAND-UP-YOUR-OWN.md)**. The MCP + workbook is an afternoon; adding the crew and owner surfaces is a weekend. Every piece is MIT, free, and optional.

### Every repo in the system

Open source, all MIT — the system reads as one thing from whichever repo you land on first:

| Repo / surface | Role | Link |
|---|---|---|
| **evolved** | 🧠 The MCP brain — 84 tools, the workbook spine, the on-chain rail, the trade packs (this repo) | [kr8tiv-ai/evolved](https://github.com/kr8tiv-ai/evolved) |
| **evolve-field-app** | ✋ The crew's hands — tap-once field capture, $0/month on Apps Script | [kr8tiv-ai/evolve-field-app](https://github.com/kr8tiv-ai/evolve-field-app) |
| **evolve-ops-workbook** | 📊 The spine — a 20-tab workbook template + the secret-gated Apps Script router the human surfaces read through (generate your own secret) | [kr8tiv-ai/evolve-ops-workbook](https://github.com/kr8tiv-ai/evolve-ops-workbook) · in-repo: [`make-workbook-template.mjs`](scripts/make-workbook-template.mjs) · [`router.gs`](templates/router.gs) |
| **evolve-dashboard** | 📈 The owner's eyes — login-protected finance/ops dashboard (runs credential-free in demo mode), live at [ops.evolveecoblasting.com](https://ops.evolveecoblasting.com) | [kr8tiv-ai/evolve-dashboard](https://github.com/kr8tiv-ai/evolve-dashboard) · [docs/DASHBOARD.md](docs/DASHBOARD.md) |
| **evolvedmcp-cloud** | 🌐 The landing page + zero-install Judge-Mode playground (the site at www.evolvedmcp.cloud) | [kr8tiv-io/evolvedmcp-cloud](https://github.com/kr8tiv-io/evolvedmcp-cloud) |

Related Evolve-brand repos: [kr8tiv-io/Evolve-Rebrand](https://github.com/kr8tiv-io/Evolve-Rebrand) (the identity system) and [kr8tiv-io/evolve-lifestyle](https://github.com/kr8tiv-io/evolve-lifestyle) (the apparel arm) — the brand this operating system runs under.

### Stand up your own — the five steps

Full guide with commands and effort estimates: **[docs/STAND-UP-YOUR-OWN.md](docs/STAND-UP-YOUR-OWN.md)**. In short:

1. **Your ops workbook** *(required, ~10 min)* — `node scripts/make-workbook-template.mjs  "My Company"` → import the 20 CSV tabs into a Google Sheet.
2. **Your MCP** *(required, ~20 min)* — clone this repo, point any MCP client at it ([CONNECT.md](docs/CONNECT.md)), and `franchise_spinup` your trade. You now have an agent-run business.
3. **Your router** *(optional, ~30 min)* — deploy the Apps Script router from [evolve-ops-workbook](https://github.com/kr8tiv-ai/evolve-ops-workbook) ([`router.gs`](templates/router.gs)) as a web app with your **own** generated secret; the field app and dashboard read through it.
4. **Your field app** *(optional, ~20 min)* — deploy [evolve-field-app](https://github.com/kr8tiv-ai/evolve-field-app), point it at your router.
5. **Your dashboard** *(optional, ~30 min)* — deploy [evolve-dashboard](https://github.com/kr8tiv-ai/evolve-dashboard) (it runs credential-free in demo mode first — `npm install && npm start`), then point it at your router and set your own login.

The MCP + workbook is an afternoon; adding the crew and owner surfaces is a weekend. Everything is optional and independent — stop after any step.

Four surfaces, one loop, all open source and free — and it begins at the MCP. The brain runs the company; the field app, the workbook, and the dashboard are how real people touch the same system. **Blasting is just the proving ground — `franchise_spinup` makes it any service business in one call.**

## Watch one agent run the whole engagement

```mermaid
%%{init: {"theme": "dark", "themeVariables": {"primaryColor": "#101010", "primaryBorderColor": "#4ade80", "primaryTextColor": "#f3f4f6", "lineColor": "#4ade80", "fontFamily": "Segoe UI"}}}%%
flowchart LR
    A[Leadtyped, voice,or photo] --> B[Priced quotelearning rates +profitability check]
    B --> G1{{"🔒 HUMAN GATEapprove the quote"}}
    G1 --> C[E-signHMAC token · declinesare final]
    C --> D[Booked on the firstGood blast dayweather-gated]
    D --> E[FLHA draftedhazards + mitigationsfrom scope]
    E --> F[Work doneactuals, inventoryburn-down, receipts]
    F --> H[Invoicedeposit applied]
    H --> I[On-chain paymentEIP-681 on X Layertestnet · replay-protected]
    I --> G2{{"🔒 HUMAN GATEconfirm settlement"}}
    G2 --> J[Review request +rate engine taught]
    J -.->|smarter pricing| B
```

Every step lands in an audit log. Try it through any MCP client: `lifecycle_start`, then `lifecycle_advance { approveQuote: true, esignSigner: "..." }`, then `lifecycle_advance { simulatePayment: true }` — or hand it a real X Layer testnet `txHash` and watch the read-only RPC verification confirm it.

## Paid on-chain (OKX X Layer)

### Why on-chain matters *here* — not as a bolt-on

A blasting crew buys media and fuel **before the first grain hits the driveway**. A trades business lives or dies on cash flow and finality, and that is exactly what on-c

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kr8tiv-ai](https://github.com/kr8tiv-ai)
- **Source:** [kr8tiv-ai/evolved](https://github.com/kr8tiv-ai/evolved)
- **License:** MIT
- **Homepage:** https://www.evolvedmcp.cloud

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-kr8tiv-ai-evolved
- Seller: https://agentstack.voostack.com/s/kr8tiv-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.