# originality-mcp

MCP server for [Originality.ai](https://originality.ai) — 5 tools covering AI detection, plagiarism checking, fact verification, readability analysis, grammar/spelling, and SEO optimization.

## Tools

| Tool | Description |
|------|-------------|
| `originality_scan` | Run a comprehensive content scan (AI, plagiarism, facts, readability, grammar, SEO) |
| `originality_batch_scan` | Process multiple content scans in a single request |
| `originality_scan_url` | Scan content from a URL instead of raw text |
| `originality_get_scan_results` | Retrieve previously stored scan results by ID |
| `originality_get_credit_balance` | Check account credit balance |

## Setup

### 1. Get an API Key

Get your API key from the [Originality.ai API Token Dashboard](https://app.originality.ai/home/api-token-dashboard).

### 2. Configure your MCP client

#### Option A: npx (no installation)

```json
{
  "mcpServers": {
    "originality": {
      "command": "npx",
      "args": ["originality-mcp"],
      "env": {
        "ORIGINALITY_API_KEY": "your-api-key"
      }
    }
  }
}
```

#### Option B: Local install

```bash
git clone https://github.com/Eyalm321/originality-mcp.git
cd originality-mcp
npm install
npm run build
```

Then configure your MCP client:

```json
{
  "mcpServers": {
    "originality": {
      "command": "node",
      "args": ["/absolute/path/to/originality-mcp/dist/index.js"],
      "env": {
        "ORIGINALITY_API_KEY": "your-api-key"
      }
    }
  }
}
```

## AI Detection Models

| Model | ID | Description |
|-------|----|-------------|
| Lite | `lite` | <1% false positive rate, allows minor AI editing |
| Turbo | `turbo` | Strictest detection, <5% false positive rate |
| Multi-Language | `multilang` | Supports 15+ languages |
| Lite Beta | `lite-102` | Latest experimental version |
| Academic | `academic` | Designed for teachers and students |

## Development

```bash
npm install
npm run build
npm test
```

## License

MIT