Evolved

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 — 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 · [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 and click Judge Mode.

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

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:

{ "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.

# 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:

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. 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 (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 (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))

%%{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 | | evolve-field-app | ✋ The crew's hands — tap-once field capture, $0/month on Apps Script | 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 · 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 | 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 |

Related Evolve-brand repos: kr8tiv-io/Evolve-Rebrand (the identity system) and 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 ([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, point it at your router.
5. Your dashboard (optional, ~30 min) — deploy 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

%%{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
• Source: kr8tiv-ai/evolved
• License: MIT
• Homepage: https://www.evolvedmcp.cloud

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