Prepare the server locally
Run this once before adding it to Claude Code.
pip install -e .Register it in Claude Code
claude mcp add -e "ORIGINALITY_API_KEY=${ORIGINALITY_API_KEY}" armavita-originality-ai -- bash /absolute/path/to/armavita-originality-ai-mcp/run.shReplace any placeholder paths in the command with the real path on your machine.
ORIGINALITY_API_KEYMake your agent remember this setup
armavita-originality-ai's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Supports AI detection, plagiarism, readability, grammar, fact-checking, and SEO scans
- Local-first architecture using stdio MCP transport
- Retrieval of scan results and account credit balance
- Compatible with Claude Code, Cursor, and other MCP clients
Tools 8
scan_aiPerforms an AI detection scan on provided content.scan_fullPerforms a comprehensive scan including multiple checks.scan_plagiarismChecks the provided content for plagiarism.scan_readabilityAnalyzes the readability of the provided content.scan_seoPerforms an SEO scan on the provided content.scan_urlInitiates a scan for a specific URL.get_scan_resultsRetrieves the results of a previously initiated scan.credit_balanceChecks the current Originality.ai account credit balance.Environment Variables
ORIGINALITY_API_KEYrequiredOriginality.ai API key used for all API requests.Try it
Original README from EfrainTorres/armavita-originality-ai-mcp
armavita-originality-ai-mcp
<strong>Brought to you by ArmaVita.com</strong> Need a custom implementation? Contact us.
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_KEYvalues. - 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
Docs
Scope
- This repository is an OSS local MCP server.
- Transport mode is local
stdioonly.
License
GNU Affero General Public License v3.0 (AGPLv3). See LICENSE.