# VerbaShield MCP Server

Official Model Context Protocol (MCP) server for [VerbaShield AI](https://verbashield.ru) — AI text detection, text humanization, and quota management for AI coding agents and assistants (Cursor, Claude Desktop, Antigravity, Windsurf, Cline).

[![smithery badge](https://smithery.ai/badge/@dalexsys/verbashield-mcp)](https://smithery.ai/server/@dalexsys/verbashield-mcp)

## Features

- **`verbashield_humanize`**: Rewrite and humanize AI-generated text into natural human Russian (modes: `academic`, `business`, `casual`).
- **`verbashield_detect`**: Analyze Russian/multilingual text for AI probability, sentence breakdown, perplexity, and burstiness.
- **`verbashield_get_quota`**: Check remaining character quota, balance, and rate limits.

---

## 🚀 Quick Start

### 1. Claude Desktop Setup

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "verbashield": {
      "command": "npx",
      "args": ["-y", "@dalexsys/verbashield-mcp"],
      "env": {
        "VERBASHIELD_API_KEY": "vs_live_your_api_key_here"
      }
    }
  }
}
```

### 2. Cursor IDE Setup

In **Cursor Settings** → **Features** → **MCP Servers** → **Add New MCP Server**:
- **Name:** `verbashield`
- **Type:** `command`
- **Command:** `env VERBASHIELD_API_KEY=vs_live_your_api_key_here npx -y @dalexsys/verbashield-mcp`

---

## 🔑 Getting an API Key

1. Log in to [verbashield.ru](https://verbashield.ru).
2. Go to **Developer Settings** or visit [verbashield.ru/docs](https://verbashield.ru/docs).
3. Create your API Key (`vs_live_...`).

---

## Tools Reference

### `verbashield_humanize`
Rewrites text to remove AI markers and clichés.
- `text` (string, required): Original text to humanize.
- `mode` (string, optional): `academic` (default), `business`, or `casual`.
- `preserve_formatting` (boolean, optional): Keep Markdown/paragraphs intact.

### `verbashield_detect`
Detects AI-generated content.
- `text` (string, required): Text to evaluate.

### `verbashield_get_quota`
Returns remaining monthly characters and rate limits.

---

## License

MIT © [VerbaShield AI](https://verbashield.ru)