# AutoTest AI — Model Context Protocol (MCP) Server

[![smithery badge](https://smithery.ai/badge/@MaaBlock/autotest-mcp)](https://smithery.ai/server/@MaaBlock/autotest-mcp)
[![glama badge](https://glama.ai/mcp/servers/@MaaBlock/autotest-mcp/badge)](https://glama.ai/mcp/servers/@MaaBlock/autotest-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**AutoTest AI** is an industrial-grade defensive testing and refactoring engine embedded directly inside your AI IDE via the **Model Context Protocol (MCP)**. It synthesizes parameterized boundary suites, audits cyclomatic branch depth, and flags missing exception boundaries with **96%+ branch coverage**.

Native zero-friction support for **Cursor**, **Claude Desktop**, **Windsurf**, and any MCP-compliant client.

---

## ⚡ Features & MCP Tools

1. **`generate_edge_tests`**:
   - Synthesizes production Pytest and Jest/Vitest test suites targeting mathematical extremes, empty/zero boundaries, type invariance, and fault injection.
   - Dual-tier synthesis:
     - **Community (Free)**: Comprehensive boundary test suites and AST defensive auditing.
     - **Enterprise Pro**: Mutation fuzz matrices and invariant verification.
2. **`audit_code_defenses`**:
   - Calculates AST cyclomatic complexity, branch depth, and identifies unhandled exception vectors.
3. **`get_paywall_status`**:
   - Inspects active Web3 payment gateways, verified on-chain sponsorship wallets, and RPC endpoints.
4. **Zero-Overhead Native Execution**:
   - Zero external third-party dependencies required. Starts in < 50ms, consumes < 15MB RAM.

---

## 🚀 1-Click Installation via Smithery CLI

Install directly into your IDE with a single command via [Smithery](https://smithery.ai):

### For Cursor IDE:
```bash
npx -y @smithery/cli install @MaaBlock/autotest-mcp --client cursor
```

### For Claude Desktop:
```bash
npx -y @smithery/cli install @MaaBlock/autotest-mcp --client claude
```

---

## 🛠️ Manual Configuration

### 1. Cursor IDE (`.cursor/mcp.json`)

Add the following to your workspace `.cursor/mcp.json` or global Cursor settings:

```json
{
  "mcpServers": {
    "autotest": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "POLYGON_PAYOUT_ADDRESS": "0x267e548ab3444aa0a671914ac7c644306a6b90b4",
        "TRON_PAYOUT_ADDRESS": "TWvzvF4FszbXM6qnBS947aNJHfyvA1kdZC"
      }
    }
  }
}
```

### 2. Claude Desktop (`claude_desktop_config.json`)

- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`  
- **Linux**: `~/.config/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "autotest": {
      "command": "python",
      "args": ["<PATH_TO_AUTOTEST_MCP>/mcp_server.py"],
      "env": {
        "POLYGON_PAYOUT_ADDRESS": "0x267e548ab3444aa0a671914ac7c644306a6b90b4",
        "TRON_PAYOUT_ADDRESS": "TWvzvF4FszbXM6qnBS947aNJHfyvA1kdZC"
      }
    }
  }
}
```

---

## 💡 Usage in Chat

Ask Cursor or Claude:
> *"Use autotest to generate full edge-case unit tests for this function."*
>
> *"Audit code defenses and cyclomatic complexity for the active file."*

---

## 💎 Web3 Paywall & Pro Upgrades

AutoTest AI operates on an autonomous Web3 freemium model:
- **Free Community Tier**: Unlimited defensive test synthesis and complexity auditing.
- **Enterprise Pro Tier**: Unlocks mutation fuzz matrices and property-based invariance testing.
- **Direct Paywall Gateway**: [https://autotest-ai.sweet-possum.workers.dev](https://autotest-ai.sweet-possum.workers.dev)
- **Official Payout Addresses**:
  - **Polygon (ERC-20 USDC)**: `0x267e548ab3444aa0a671914ac7c644306a6b90b4` ([View on PolygonScan](https://polygonscan.com/address/0x267e548ab3444aa0a671914ac7c644306a6b90b4))
  - **TRON (TRC-20 USDT)**: `TWvzvF4FszbXM6qnBS947aNJHfyvA1kdZC` ([View on TronScan](https://tronscan.org/#/address/TWvzvF4FszbXM6qnBS947aNJHfyvA1kdZC))

---

## 📜 License

Released under the [MIT License](LICENSE). Copyright (c) 2026 AutoTest AI.