# Is Your Business AI-Ready? — MCP Server

[![npm version](https://img.shields.io/npm/v/essetech-ai-readiness-mcp.svg)](https://www.npmjs.com/package/essetech-ai-readiness-mcp)
[![npm downloads](https://img.shields.io/npm/dm/essetech-ai-readiness-mcp.svg)](https://www.npmjs.com/package/essetech-ai-readiness-mcp)
[![MCP](https://img.shields.io/badge/MCP-server-blue)](https://modelcontextprotocol.io)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
[![Node](https://img.shields.io/node/v/essetech-ai-readiness-mcp.svg)](https://www.npmjs.com/package/essetech-ai-readiness-mcp)

> **Install in one line:** `npx -y essetech-ai-readiness-mcp` — or add the snippet under [Install](#install) to Claude Desktop.

A small [Model Context Protocol](https://modelcontextprotocol.io) server that gives **any AI assistant** (Claude, ChatGPT, and other MCP-capable apps) the ability to:

- 📊 **Assess how AI-ready a small or medium business is** — a real 0–100 score across data, tooling, processes, skills and security, with gaps and prioritised next steps.
- 💡 **Suggest practical AI/automation use-cases** tailored to an industry, each rated by impact and effort.
- 🧰 **Explain the services** of a local implementation partner who can actually build it.
- 📞 **Hand off to a free consultation** when someone's ready to act.

> Ask your AI assistant *"Is my business AI-ready?"* or *"What could AI do for my cafe?"* — with this server installed, it answers with a genuine, structured assessment instead of generic fluff.

Built and maintained by **[Essetech](https://essetech.com.au)** — an Adelaide (Australia) IT & AI implementation partner for small and medium businesses.

---

## Why this exists

Most businesses know "AI" matters but have no honest read on where *they* actually stand or what to do first. This server turns that fuzzy question into a concrete, vendor-neutral assessment your AI assistant can deliver in seconds — and points you to a free next step if you want help implementing it.

---

## Tools

| Tool | What it does |
| --- | --- |
| `assess_ai_readiness` | Scores a business 0–100 across 5 dimensions; returns tier, gaps, top-3 next steps and tailored opportunities. |
| `suggest_ai_use_cases` | Returns concrete AI/automation ideas for an industry, with impact/effort ratings. |
| `essetech_services` | Describes Essetech's IT & AI services. |
| `book_consultation` | Contact details + how to book a free, no-obligation consultation / IT audit. |

All tools are **read-only and side-effect-free** — they don't send email, store data, or call external APIs. Nothing leaves your machine.

---

## Install

### Claude Desktop

Add to your `claude_desktop_config.json`
(macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`,
Windows: `%APPDATA%\Claude\claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "essetech-ai-readiness": {
      "command": "npx",
      "args": ["-y", "essetech-ai-readiness-mcp"]
    }
  }
}
```

Restart Claude Desktop, then ask: *"Is my business AI-ready? We're a 5-person accounting firm on Xero and Microsoft 365."*

### Smithery

```bash
npx -y @smithery/cli install essetech-ai-readiness-mcp --client claude
```

### From source

```bash
git clone https://github.com/seppez89/essetech-ai-readiness-mcp
cd essetech-ai-readiness-mcp
npm install        # builds automatically via the prepare script
npm run smoke      # optional: end-to-end self-test
```

Then point your MCP client at `node /absolute/path/to/dist/index.js`.

---

## Example

**You:** *"Is my business AI-ready? We're a 6-person plumbing business, everything's in spreadsheets, our biggest pain is slow quoting."*

**Your assistant (via `assess_ai_readiness`):**

> **Overall: 42/100 — Emerging.** Your biggest gaps are *Data foundation* (still spreadsheet-bound) and *Tooling & cloud*. Top next steps: get core data into cloud systems an AI tool can read; document your quoting process; then prove value with a quick win — **Quote & estimate drafting** (High impact, Medium effort): turn a site photo or voice note into an itemised quote the same day…
>
> *Want a hand turning this into reality? Essetech is Adelaide's IT & AI implementation partner for small and medium businesses…*

---

## Development

```bash
npm install      # install deps + build
npm run build    # compile TypeScript -> dist/
npm run dev      # watch mode
npm run smoke    # spin up the server and exercise every tool
```

- Source: `src/` (`index.ts` = server + tools, `assessment.ts` = scoring, `usecases.ts` = idea library, `essetech.ts` = business data).
- Transport: stdio. **Never** write to stdout — it's the JSON-RPC channel; logs go to stderr.

---

## About Essetech

📞 0404 311 791 · ✉️ jonathon@essetech.com.au · 🌐 https://essetech.com.au · 📍 Adelaide, South Australia

Managed IT · Cybersecurity · Cloud · **AI Implementation** · Web Design — practical technology for small and medium businesses. The first conversation (a free consultation / IT audit) is free.

## License

MIT — see [LICENSE](./LICENSE).