Skip to main content
Glama

ZeroTrue MCP Server

npm version npm downloads License: MIT Node.js

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

Install in VS Code Install in VS Code Insiders

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

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
0dRelease cycle
2Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZeroTrueLCC/mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server