AI or Not MCP Server

License: MIT npm version MCP

An MCP (Model Context Protocol) server that integrates with the AI or Not API to detect AI-generated content in images, videos, audio, and text.

Features

Image Analysis: Detect AI-generated images, deepfakes, NSFW content, and image quality issues
Video Analysis: Detect AI-generated video, synthetic voices, AI music, and video deepfakes
Audio Analysis: Detect AI-generated music and synthetic voices
Text Analysis: Detect AI-written text with confidence scoring and annotations
API Health Check: Verify API availability

Prerequisites

Node.js 18+
An API key from AI or Not

Installation

From Source

git clone https://github.com/tymrtn/aiornot-mcp.git
cd aiornot-mcp
npm install
npm run build

From npm (coming soon)

npm install -g aiornot-mcp

Configuration

Environment Variables

Variable	Required	Default	Description
`AIORNOT_API_KEY`	Yes	-	Your AI or Not API key
`AIORNOT_API_URL`	No	`https://api.aiornot.com`	API base URL

Claude Desktop / Claude Code

Add to your MCP settings file:

{
  "mcpServers": {
    "aiornot": {
      "command": "node",
      "args": ["/path/to/aiornot-mcp/build/index.js"],
      "env": {
        "AIORNOT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Settings file locations:

Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code: ~/.claude/mcp_servers.json

Usage

Running the Server

AIORNOT_API_KEY="your_api_key_here" node build/index.js

Available Tools

`aiornot_analyze_media`

Analyze media content for AI generation.

Parameters:

Parameter	Type	Required	Description
`media_type`	string	Yes	One of: `image`, `video`, `text`, `audio_music`, `audio_voice`
`file_path`	string	Conditional	Path to file (required for image/video/audio)
`text`	string	Conditional	Text content (required for text, min 250 chars)
`only`	string[]	No	Report types to include
`excluding`	string[]	No	Report types to exclude
`external_id`	string	No	Tracking identifier
`include_annotations`	boolean	No	Include block-level annotations (text only)
`timeout_ms`	number	No	Override request timeout

Report Types by Media:

Media Type	Available Reports
Image	`ai_generated`, `deepfake`, `nsfw`, `quality`, `reverse_search`
Video	`ai_video`, `ai_music`, `ai_voice`, `deepfake_video` (off by default)

`aiornot_is_live`

Check if the AI or Not API is available.

Examples

Analyze an image:

{
  "media_type": "image",
  "file_path": "/path/to/image.jpg"
}

Analyze an image for specific checks:

{
  "media_type": "image",
  "file_path": "/path/to/image.jpg",
  "only": ["ai_generated", "deepfake"]
}

Analyze video including deepfake detection:

{
  "media_type": "video",
  "file_path": "/path/to/video.mp4",
  "only": ["ai_video", "deepfake_video"]
}

Analyze text:

{
  "media_type": "text",
  "text": "Your text content here (minimum 250 characters)...",
  "include_annotations": true
}

Analyze audio for synthetic voice:

{
  "media_type": "audio_voice",
  "file_path": "/path/to/audio.mp3"
}

Response Format

The server returns structured JSON with:

media_type: The analyzed media type
scores: Extracted confidence scores and verdicts
response: Full API response

Example response for image analysis:

{
  "media_type": "image",
  "scores": {
    "ai_generated": {
      "verdict": "ai",
      "ai_confidence": 0.95,
      "human_confidence": 0.05
    },
    "deepfake": {
      "is_detected": false,
      "confidence": 0.02
    }
  },
  "response": { ... }
}

Timeouts

Default timeouts vary by media type:

Media Type	Default Timeout
Image	30 seconds
Text	30 seconds
Video	120 seconds
Audio (music)	120 seconds
Audio (voice)	120 seconds

Use timeout_ms to override if needed.

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run watch

# Test with MCP Inspector
npm run inspector

License

MIT - see LICENSE