armavita-originality-ai-mcp

armavita-originality-ai-mcp is a local-first MCP server for Originality.ai scanning workflows. It is built for local MCP clients (Claude Code, Cursor, Codex) and supports:

AI detection, plagiarism, readability, grammar, fact-checking, and SEO scans
stdio MCP transport only
Python >=3.11
mcp==1.26.0
License: AGPL-3.0-only

Current contract version: 2.0.0.

Install

Package install (enables the armavita-originality-ai-mcp CLI):

pip install -e .

Local launcher install (recommended for repo development):

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Run

bash ./run.sh

Alternative entrypoints:

python run.py
armavita-originality-ai-mcp

Required Environment Variable

ORIGINALITY_API_KEY: Originality.ai API key used for all API requests.

Quick MCP Client Config

Canonical server key and path:

{
  "mcpServers": {
    "armavita-originality-ai": {
      "command": "bash",
      "args": ["/absolute/path/to/armavita-originality-ai-mcp/run.sh"],
      "env": {
        "ORIGINALITY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tool Coverage

Scanning: scan_ai, scan_full, scan_plagiarism, scan_readability, scan_seo, scan_url
Retrieval and account: get_scan_results, credit_balance

Security

Never commit real ORIGINALITY_API_KEY values.
Keep credentials in client/server env config, not in source files.

Development

Quick syntax check:

python -m py_compile run.py armavita_originality_ai_mcp/server.py armavita_originality_ai_mcp/client.py armavita_originality_ai_mcp/handlers/scan_handlers.py armavita_originality_ai_mcp/tools/scan_tools.py