identifAI MCP Server

Upload an image file to detect whether it is human-made or AI-generated. Provide the image content as a base64-encoded string. Returns a classification identifier for async result retrieval. WARNING: base64 encoding adds ~33% overhead to the original file size. For images larger than 4 MB, use classify_image_url instead and provide a publicly accessible URL to avoid payload size issues. Authentication: provide your Identifai API key via the apiKey parameter or configure the X-Api-Key HTTP header in your MCP client (recommended).

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "fileData": {
      "type": "string",
      "description": "Base64-encoded raw binary content of the image file to classify. Do not pass a file-system path; encode the file bytes directly as base64. Only suitable for files up to ~4 MB; for larger images use classify_image_url with a publicly accessible URL."
    },
    "filename": {
      "type": "string",
      "description": "Optional file name including extension (e.g. photo.jpg). Used to hint the media type."
    },
    "refId": {
      "type": "string",
      "description": "Optional caller-defined reference ID attached to the result"
    },
    "withMorphing": {
      "type": "boolean",
      "description": "Enable face morphing analysis on the image"
    },
    "withTampering": {
      "type": "boolean",
      "description": "Enable tampering/splicing detection on the image"
    },
    "withHeatmap": {
      "type": "boolean",
      "description": "Generate an AI content heatmap alongside the classification"
    },
    "noCache": {
      "type": "boolean",
      "description": "Bypass cache and force a fresh classification"
    },
    "withNsfw": {
      "type": "boolean",
      "description": "Enable NSFW (Not Safe For Work) content detection on the image"
    },
    "preventC2paForces": {
      "type": "boolean",
      "description": "If true, a C2PA signature will not force the classification to artificial"
    }
  },
  "required": [
    "fileData"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Submit a publicly accessible image URL to detect whether it is human-made or AI-generated. Returns a classification identifier for result retrieval. Supports the same analysis options as file-based classification. Authentication: provide your Identifai API key via the apiKey parameter or configure the X-Api-Key HTTP header in your MCP client (recommended).

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "imageUrl": {
      "type": "string",
      "description": "Public HTTP/HTTPS URL of the image to classify"
    },
    "refId": {
      "type": "string",
      "description": "Optional caller-defined reference ID"
    },
    "withMorphing": {
      "type": "boolean",
      "description": "Enable face morphing analysis"
    },
    "withTampering": {
      "type": "boolean",
      "description": "Enable tampering/splicing detection"
    },
    "withHeatmap": {
      "type": "boolean",
      "description": "Generate an AI content heatmap"
    },
    "noCache": {
      "type": "boolean",
      "description": "Bypass cache and force fresh classification"
    },
    "withNsfw": {
      "type": "boolean",
      "description": "Enable NSFW (Not Safe For Work) content detection on the image"
    },
    "preventC2paForces": {
      "type": "boolean",
      "description": "If true, a C2PA signature will not force the classification to artificial"
    }
  },
  "required": [
    "imageUrl"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Retrieve the classification result for a previously submitted image. Use the identifier returned by classify_image or classify_image_url. Poll this endpoint until the result is available.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "description": "Classification identifier returned by the submission endpoint"
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Retrieve classification results for multiple images in a single request. Accepts up to 100 identifiers. Useful for batch result polling.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "identifiers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of classification identifiers (max 100)"
    }
  },
  "required": [
    "identifiers"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Retrieve a visual heatmap highlighting which regions of the image were detected as AI-generated. Requires the classification to have been submitted with withHeatmap enabled.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "description": "Classification identifier for which to fetch the heatmap"
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Manually override the classification verdict for a previously classified image. Sets the result to either "human" or "artificial". Used for corrections and feedback.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "description": "Classification identifier to override"
    },
    "classification": {
      "type": "string",
      "enum": [
        "human",
        "artificial"
      ],
      "description": "The correct classification value to apply"
    }
  },
  "required": [
    "identifier",
    "classification"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Upload a video file to detect whether it is human-made or AI-generated. Provide the video content as a base64-encoded string. The video is split into frames which are individually classified. Returns a classification identifier for async result retrieval. WARNING: base64 encoding adds ~33% overhead to the original file size. For videos larger than 10 MB, use classify_video_url instead and provide a publicly accessible URL to avoid payload size issues. Authentication: provide your Identifai API key via the apiKey parameter or configure the X-Api-Key HTTP header in your MCP client (recommended).

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "fileData": {
      "type": "string",
      "description": "Base64-encoded raw binary content of the video file to classify. Do not pass a file-system path; encode the file bytes directly as base64. Only suitable for files up to ~10 MB; for larger videos use classify_video_url with a publicly accessible URL."
    },
    "filename": {
      "type": "string",
      "description": "Optional file name including extension (e.g. clip.mp4). Used to hint the media type."
    },
    "refId": {
      "type": "string",
      "description": "Optional caller-defined reference ID"
    },
    "frames": {
      "type": "string",
      "enum": [
        "5",
        "10",
        "30"
      ],
      "description": "Maximum number of frames to extract and classify"
    },
    "keyFrames": {
      "type": "boolean",
      "description": "Extract key frames rather than uniform frames"
    },
    "keyFramesMethod": {
      "type": "string",
      "enum": [
        "iframes",
        "flow",
        "color"
      ],
      "description": "Algorithm used for key frame extraction"
    },
    "withTampering": {
      "type": "boolean",
      "description": "Enable tampering detection on video frames"
    },
    "withMorphing": {
      "type": "boolean",
      "description": "Enable face morphing analysis on video frames"
    },
    "noCache": {
      "type": "boolean",
      "description": "Bypass cache and force fresh classification"
    },
    "withNsfw": {
      "type": "boolean",
      "description": "Enable NSFW (Not Safe For Work) content detection on video frames"
    },
    "withAudio": {
      "type": "boolean",
      "description": "[BETA] Analyze the audio track of the video in addition to the frames. Requires enablement in the pricing plan."
    },
    "preventC2paForces": {
      "type": "boolean",
      "description": "If true, a C2PA signature will not force the classification to artificial"
    },
    "ensureFacePerFrame": {
      "type": "boolean",
      "description": "Ensure at least one face is detected in each frame used for classification. Useful combined with withMorphing to detect face swaps. May increase processing time."
    }
  },
  "required": [
    "fileData"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Submit a publicly accessible video URL for AI-generated content detection. Supports the same frame extraction and analysis options as file-based classification. Authentication: provide your Identifai API key via the apiKey parameter or configure the X-Api-Key HTTP header in your MCP client (recommended).

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "videoUrl": {
      "type": "string",
      "description": "Public HTTP/HTTPS URL of the video to classify"
    },
    "refId": {
      "type": "string",
      "description": "Optional caller-defined reference ID"
    },
    "frames": {
      "type": "string",
      "enum": [
        "5",
        "10",
        "30"
      ],
      "description": "Maximum frames to extract"
    },
    "keyFrames": {
      "type": "boolean",
      "description": "Extract key frames"
    },
    "keyFramesMethod": {
      "type": "string",
      "enum": [
        "iframes",
        "flow",
        "color"
      ],
      "description": "Key frame extraction algorithm"
    },
    "withTampering": {
      "type": "boolean",
      "description": "Enable tampering detection"
    },
    "withMorphing": {
      "type": "boolean",
      "description": "Enable face morphing analysis"
    },
    "noCache": {
      "type": "boolean",
      "description": "Bypass cache"
    },
    "withNsfw": {
      "type": "boolean",
      "description": "Enable NSFW (Not Safe For Work) content detection on video frames"
    },
    "withAudio": {
      "type": "boolean",
      "description": "[BETA] Analyze the audio track of the video. Requires enablement in the pricing plan."
    },
    "preventC2paForces": {
      "type": "boolean",
      "description": "If true, a C2PA signature will not force the classification to artificial"
    },
    "ensureFacePerFrame": {
      "type": "boolean",
      "description": "Ensure at least one face is detected per frame. Useful with withMorphing."
    }
  },
  "required": [
    "videoUrl"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Retrieve the classification result for a previously submitted video. Poll until the result is ready — video classification is always asynchronous.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "description": "Classification identifier returned by the submission endpoint"
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Retrieve classification results for multiple videos in a single request. Accepts up to 100 identifiers.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "identifiers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of classification identifiers (max 100)"
    }
  },
  "required": [
    "identifiers"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Manually override the classification verdict for a previously classified video. Sets the result to either "human" or "artificial".

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "description": "Classification identifier to override"
    },
    "classification": {
      "type": "string",
      "enum": [
        "human",
        "artificial"
      ],
      "description": "The correct classification value to apply"
    }
  },
  "required": [
    "identifier",
    "classification"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Upload an audio or speech file to detect whether it is human-recorded or AI-synthesized. Provide the audio content as a base64-encoded string. Returns a classification identifier for async result retrieval. WARNING: base64 encoding adds ~33% overhead to the original file size. For audio files larger than 10 MB, use classify_audio_url instead and provide a publicly accessible URL to avoid payload size issues. Authentication: provide your Identifai API key via the apiKey parameter or configure the X-Api-Key HTTP header in your MCP client (recommended).

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "fileData": {
      "type": "string",
      "description": "Base64-encoded raw binary content of the audio file to classify. Do not pass a file-system path; encode the file bytes directly as base64. Only suitable for files up to ~10 MB; for larger audio files use classify_audio_url with a publicly accessible URL."
    },
    "filename": {
      "type": "string",
      "description": "Optional file name including extension (e.g. voice.mp3). Used to hint the media type."
    },
    "refId": {
      "type": "string",
      "description": "Optional caller-defined reference ID"
    },
    "noCache": {
      "type": "boolean",
      "description": "Bypass cache and force fresh classification"
    },
    "preventC2paForces": {
      "type": "boolean",
      "description": "If true, a C2PA signature will not force the classification to artificial"
    }
  },
  "required": [
    "fileData"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Submit a publicly accessible audio URL for AI-generated speech detection. Returns a classification identifier for async result retrieval. Authentication: provide your Identifai API key via the apiKey parameter or configure the X-Api-Key HTTP header in your MCP client (recommended).

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "audioUrl": {
      "type": "string",
      "description": "Public HTTP/HTTPS URL of the audio to classify"
    },
    "refId": {
      "type": "string",
      "description": "Optional caller-defined reference ID"
    },
    "noCache": {
      "type": "boolean",
      "description": "Bypass cache"
    },
    "preventC2paForces": {
      "type": "boolean",
      "description": "If true, a C2PA signature will not force the classification to artificial"
    }
  },
  "required": [
    "audioUrl"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Retrieve the classification result for a previously submitted audio file. Poll until the result is ready.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "description": "Classification identifier returned by the submission endpoint"
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Retrieve classification results for multiple audio files in a single request. Accepts up to 100 identifiers.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "identifiers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of classification identifiers (max 100)"
    }
  },
  "required": [
    "identifiers"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Manually override the classification verdict for a previously classified audio file. Sets the result to either "human" or "artificial".

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "description": "Classification identifier to override"
    },
    "classification": {
      "type": "string",
      "enum": [
        "human",
        "artificial"
      ],
      "description": "The correct classification value to apply"
    }
  },
  "required": [
    "identifier",
    "classification"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Retrieve the current available and used classification credits for the authenticated Identifai account. Use this to check quota status before submitting large batches.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Submit one or more ticket images (as base64-encoded strings) to the Identifai v2 API for batch tampering detection. Each ticket is analysed independently; results are retrieved asynchronously via get_tampering_batch_results using the returned batch_id. Supports PDF files (each page becomes a separate analysis entry). Maximum 10 tickets per batch. Authentication: provide your Identifai API key via the apiKey parameter or configure the X-Api-Key HTTP header in your MCP client (recommended).

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "tickets": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of base64-encoded raw binary content of ticket image/PDF files to analyse. Do not pass file-system paths; encode the file bytes directly as base64. Maximum 10 items. For single files, wrap in an array: [\"<base64>\"]."
    },
    "filenames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional array of filenames (e.g. [\"ticket1.jpg\", \"ticket2.pdf\"]). Must match the length of the tickets array if provided."
    },
    "refIds": {
      "type": "string",
      "description": "Comma-separated list of reference IDs, one per ticket (e.g. \"TICKET-001,TICKET-002\"). Must match the number of tickets if provided."
    },
    "models": {
      "type": "string",
      "description": "Comma-separated list of model names to use for detection. If omitted, all models available in the pricing plan are used."
    }
  },
  "required": [
    "tickets"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Retrieve the tampering detection results for a previously submitted batch of tickets. Poll until the "done" field is true. Each result contains a verdict ("authentic" or "tampered") and per-heuristic verdicts.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "Identifai API key used to authenticate requests to the Identifai backend. Optional when the MCP client is configured to send the X-Api-Key HTTP header (the recommended approach for remote server deployments — set it once in your MCP client config). Required only when the header is not configured. Never use a placeholder value — only pass the real key supplied by the user. Keys can be obtained from the Identifai dashboard at https://identifai.net.",
      "type": "string"
    },
    "batchId": {
      "type": "string",
      "description": "Batch identifier returned by submit_tampering_tickets"
    }
  },
  "required": [
    "batchId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}