ArmaVita Originality AI MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
pip install -e .
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "ORIGINALITY_API_KEY=${ORIGINALITY_API_KEY}" armavita-originality-ai -- bash "<FULL_PATH_TO_ARMAVITA_ORIGINALITY_AI_MCP>/dist/index.js"

Replace <FULL_PATH_TO_ARMAVITA_ORIGINALITY_AI_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:ORIGINALITY_API_KEY
README.md

Local-first MCP server for Originality.ai scanning workflows.

armavita-originality-ai-mcp

Brought to you by ArmaVita.com 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_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

Docs

Scope

  • This repository is an OSS local MCP server.
  • Transport mode is local stdio only.

License

GNU Affero General Public License v3.0 (AGPLv3). See LICENSE.

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.

Configuration

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

Try it

Check the AI detection score for the text in my current file.
Run a full plagiarism and SEO scan on the content I just wrote.
What is my current credit balance on Originality.ai?
Retrieve the results for the scan I just performed using the scan ID.
Analyze the readability of this document to ensure it meets our content standards.

Frequently Asked Questions

What are the key features of ArmaVita Originality AI?

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.

What can I use ArmaVita Originality AI for?

Automating content quality checks for editorial teams directly within the IDE. Integrating AI detection into local writing workflows for content creators. Monitoring SEO and plagiarism metrics during the content development process. Programmatically checking account usage and credits for content agencies.

How do I install ArmaVita Originality AI?

Install ArmaVita Originality AI by running: pip install -e .

What MCP clients work with ArmaVita Originality AI?

ArmaVita Originality AI works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep ArmaVita Originality AI docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare