Metadata-Version: 2.4
Name: gptzero-mcp
Version: 0.1.0
Summary: MCP server for GPTZero AI content detection — sentence-level and paragraph-level scoring
Project-URL: Homepage, https://github.com/cphoskins/gptzero-mcp
Project-URL: Repository, https://github.com/cphoskins/gptzero-mcp
Project-URL: Issues, https://github.com/cphoskins/gptzero-mcp/issues
Author-email: Paul Hoskins <paul@proactioncto.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ai-detection,content-detection,gptzero,llm,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: httpx
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# gptzero-mcp

MCP server for [GPTZero](https://gptzero.me) AI content detection. Get sentence-level and paragraph-level AI probability scores so you can surgically identify and fix AI-generated content.

## Installation

```bash
pip install gptzero-mcp
```

## Configuration

Set your API key as an environment variable:

```bash
export GPTZERO_API_KEY=your_api_key_here
```

Get your API key at [app.gptzero.me/api](https://app.gptzero.me/api).

### Claude Code

```bash
claude mcp add -s user -e GPTZERO_API_KEY=your_key gptzero -- gptzero-mcp
```

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "gptzero": {
      "command": "gptzero-mcp",
      "env": {
        "GPTZERO_API_KEY": "your_key"
      }
    }
  }
}
```

## Tools

### `detect_text`

Full AI detection with sentence-level and paragraph-level scoring. Returns:
- Overall classification (human/ai/mixed) with confidence
- Per-sentence AI probability and flags
- Per-paragraph AI probability
- Burstiness and perplexity metrics

### `detect_text_summary`

Quick overview — overall score plus only the flagged sentences.

### `detect_files`

Scan document files (PDF, DOCX, TXT). Up to 50 files per request.

### `list_model_versions`

List available GPTZero detection model versions.

## Example

```
> detect_text("Your content here...")

{
  "classification": "ai",
  "confidence": "high",
  "confidence_score": 0.95,
  "sentences": [
    {
      "sentence": "Your content here...",
      "ai_probability": 0.98,
      "flagged_as_ai": true
    }
  ]
}
```

## License

MIT
