ZeroTrue MCP Server

Official Model Context Protocol server for the ZeroTrue AI Detection API. Detect AI-generated text, images, video, and audio from any MCP-compatible agent or IDE.

Quick Start

Requires a ZeroTrue API key. Get one at zerotrue.app.

ZEROTRUE_API_KEY=zt_your_key npx -y @zerotrue/mcp stdio

Tools

| Tool | Description | | --- | --- | | zerotrue_analyze_text | Detect AI-generated content in plain text | | zerotrue_analyze_url | Analyze media or text at a direct HTTP(S) URL | | zerotrue_analyze_local_file | Analyze a local file by path (preferred for desktop/CLI clients) | | zerotrue_analyze_file | Analyze a Base64-encoded file | | zerotrue_get_result | Retrieve a previous analysis result by ID | | zerotrue_get_api_info | Return API metadata and supported formats |

All tools accept optional isDeepScan and isPrivateScan flags where applicable.

zerotrue_analyze_local_file

The recommended tool for local MCP clients. Pass an absolute path: the server validates the file, detects its MIME type, and uploads it as a multipart form to ZeroTrue. No manual Base64 encoding needed.

{ "path": "/Users/alex/Downloads/photo.png", "isPrivateScan": true }

zerotrue_analyze_text

{ "text": "Paste the content here...", "isDeepScan": false }

zerotrue_analyze_url

{ "url": "https://example.com/video.mp4", "isPrivateScan": true }

zerotrue_get_result

{ "id": "246c6522-195d-45d3-af96-0f2360d2e0bc" }

Response Format

Every tool returns a consistent JSON envelope:

{
  "ok": true,
  "data": {
    "id": "246c6522-195d-45d3-af96-0f2360d2e0bc",
    "status": "completed",
    "result": {
      "ai_probability": 0.998,
      "human_probability": 0.002,
      "result_type": "ai_generated",
      "feedback": "High probability of AI generation detected"
    }
  }
}

Errors use the same shape with ok: false:

{
  "ok": false,
  "error": {
    "statusCode": 401,
    "message": "ZeroTrue API key is required.",
    "code": "ZEROTRUE_API_ERROR"
  }
}

Client Setup

[mcp_servers.zerotrue]
command = "npx"
args = ["-y", "@zerotrue/mcp", "stdio"]

[mcp_servers.zerotrue.env]
ZEROTRUE_API_KEY = "zt_your_key"

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "zerotrue": {
      "command": "npx",
      "args": ["-y", "@zerotrue/mcp", "stdio"],
      "env": {
        "ZEROTRUE_API_KEY": "zt_your_key"
      }
    }
  }
}

copilot mcp add zerotrue \
  --transport stdio \
  --env ZEROTRUE_API_KEY=zt_your_key \
  --tools '*' \
  --timeout 310000 \
  -- npx -y @zerotrue/mcp stdio

Or add manually to your workspace .vscode/mcp.json:

{
  "inputs": [
    {
      "id": "zerotrue-api-key",
      "type": "promptString",
      "description": "ZeroTrue API key",
      "password": true
    }
  ],
  "servers": {
    "zerotrue": {
      "command": "npx",
      "args": ["-y", "@zerotrue/mcp", "stdio"],
      "env": {
        "ZEROTRUE_API_KEY": "${input:zerotrue-api-key}"
      }
    }
  }
}

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "zerotrue": {
      "command": "npx",
      "args": ["-y", "@zerotrue/mcp", "stdio"],
      "env": {
        "ZEROTRUE_API_KEY": "zt_your_key"
      }
    }
  }
}

Use the IDE MCP settings panel with a local stdio server:

{
  "mcpServers": {
    "zerotrue": {
      "command": "npx",
      "args": ["-y", "@zerotrue/mcp", "stdio"],
      "env": {
        "ZEROTRUE_API_KEY": "zt_your_key"
      }
    }
  }
}

Run the HTTP server:

ZEROTRUE_API_KEY=zt_your_key \
ZEROTRUE_MCP_PORT=8787 \
npx -y @zerotrue/mcp http

Or with Docker:

docker run -p 8787:8787 \
  -e ZEROTRUE_API_KEY=zt_your_key \
  zerotrue/mcp

MCP endpoint: http://localhost:8787/mcp Health check: http://localhost:8787/healthz

Point your MCP client to the endpoint above. For production, place the server behind HTTPS and add authentication.

Configuration

| Variable | Default | Description | | --- | --- | --- | | ZEROTRUE_API_KEY | (required) | ZeroTrue API key (zt_...). Required for all analysis tools. | | ZEROTRUE_API_BASE_URL | https://api.zerotrue.app | ZeroTrue API base URL | | ZEROTRUE_API_TIMEOUT_MS | 310000 | Request timeout in milliseconds | | ZEROTRUE_MAX_FILE_BYTES | 104857600 | Max local file size (default 100 MB) | | ZEROTRUE_MCP_TRANSPORT | stdio | Transport mode: stdio or http | | ZEROTRUE_MCP_HOST | 0.0.0.0 | HTTP bind host | | ZEROTRUE_MCP_PORT | 8787 | HTTP bind port | | ZEROTRUE_MCP_ENDPOINT | /mcp | HTTP MCP path |

Example Prompts

Is this text AI-generated? "The quantum entanglement of..."

Analyze https://example.com/profile.jpg with ZeroTrue and summarize the result.

Use ZeroTrue to check /Downloads/video.mp4. Keep the scan private.

Get ZeroTrue result 246c6522-195d-45d3-af96-0f2360d2e0bc and explain the verdict.

Security

• Store ZEROTRUE_API_KEY in your MCP client config, never in source control.
• Prefer stdio mode for personal use: your key never leaves your machine.
• zerotrue_analyze_local_file can only access files readable by the MCP server process.
• For HTTP deployments, do not expose the /mcp endpoint publicly without authentication and rate limiting.

Troubleshooting

ZeroTrue API key is required - Set ZEROTRUE_API_KEY in the environment where the MCP server starts.

File is not readable or does not exist - Use an absolute path and confirm the MCP server process has read access.

fetch failed - Check connectivity: curl https://api.zerotrue.app/api/v1/info. If details.cause.code is present, use it to diagnose DNS, TLS, or proxy issues.

Stale tool behavior after an update - Restart the MCP client. Most clients keep MCP subprocesses alive between tool calls.

Requirements

• Node.js >= 20.11

License

MIT