growaify-mcp

# Growaify MCP Server

Official MCP (Model Context Protocol) server for the [Growaify](https://growaify.com) autonomous commerce platform.

> **This server implements the [Growaify Protocol](https://github.com/h-abar/growaify-protocol)** — the open spec, JSON schemas, conformance suite, and Agent/Provider SDKs live there. Verify any deployment: `python conformance/run.py https://growaify.com`

Growaify lets AI agents discover services, negotiate binding quotes, place idempotent orders, pay, and receive **cryptographically verified deliverables** — fully autonomously.

## What you can do with this server

| Tool | Description |
|---|---|
| `discover_capabilities` | Match your requirements (e.g. `["whatsapp", "booking"]`) against available services |
| `create_binding_quote` | Get a deterministic, binding quote with agent pricing |
| `purchase_service` | Place a state-machine order with verified payment rails |
| `track_order_telemetry` | Track order status, progress (0–100%), and deliverables |
| `query_trust_and_sla` | Inspect checksums, refund policies, and trust metadata |

## Available services

| Service | Agent price | What you get |
|---|---|---|
| Smart Consultation | $1 | Tailored written consultation (immigration, legal, work, study) |
| Autonomous AI Task Worker | $15 | Finished written work: descriptions, replies, translations |
| AI Website + Booking | $69 | SEO-ready website with self-service booking |
| n8n / AI Automation | $69 | Custom n8n workflow, built, tested, deployed |
| AI WhatsApp Receptionist | $39 | 24/7 AI receptionist provisioning |

## Installation

### Via Smithery (recommended)

```bash
npx -y @smithery/cli install @habar/growaify --client claude
```

### Claude Desktop

Add to `claude_desktop_config.json` (Settings → Developer → Edit Config):

```json
{
  "mcpServers": {
    "growaify": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://growaify.com/mcp", "--header", "X-API-Key:YOUR_API_KEY"]
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json` in your project root (or via Settings → MCP):

```json
{
  "mcpServers": {
    "growaify": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://growaify.com/mcp", "--header", "X-API-Key:YOUR_API_KEY"]
    }
  }
}
```

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "growaify": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://growaify.com/mcp", "--header", "X-API-Key:YOUR_API_KEY"]
    }
  }
}
```

> **Discovery is open** — `initialize`, `tools/list`, `ping`, and `discover_capabilities` work with **no API key**. Commerce tools (`create_binding_quote`, `purchase_service`, `track_order_telemetry`, `query_trust_and_sla`) require `X-API-Key`. You can connect without a key to inspect the surface; add one when you're ready to transact.

## Example agent workflow

```text
1. discover_capabilities(required_capabilities=["booking", "multilingual"])
2. create_binding_quote(service_id="website-booking")
3. purchase_service(quote_id="Q-...", email="agent@example.com")
4. track_order_telemetry(order_id="ORD-...")  → deliverables + checksum
```

## Trust & verification

- Every deliverable ships with a **SHA-256 checksum**
- Orders are **idempotent** and enforced by a strict state machine
- Payments verified via PayPal NCP (webhook or operator secret) — never client assertion; x402 USDC rail deferred until on-chain verification
- Agent Card: https://growaify.com/.well-known/agent.json
- Trust portal: https://growaify.com/trust.html
- Live trust metrics: https://growaify.com/api/v1/trust (computed from real order records)

## Links

- Website: https://growaify.com
- **Protocol spec + SDKs + conformance suite**: https://github.com/h-abar/growaify-protocol
- Agent Card: https://growaify.com/.well-known/agent.json
- OpenAPI spec: https://growaify.com/openapi.json
- Service catalog: https://growaify.com/catalog.json
- Agent SDK (Python): [`sdk/agent/growaify_agent.py`](https://github.com/h-abar/growaify-protocol/blob/main/sdk/agent/growaify_agent.py)
- Provider SDK (Python): [`sdk/provider/growaify_provider.py`](https://github.com/h-abar/growaify-protocol/blob/main/sdk/provider/growaify_provider.py)
- Live sandbox: https://growaify.com/sandbox.html

## License

MIT