# afghanfansmedia-ai/songcheck-mcp [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/afghanfansmedia-ai/songcheck-mcp  
**GitHub Stars:** 1  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/afghanfansmedia-ai-songcheck-mcp

## Description
Is this song AI or human? Detect AI-generated music (Suno, Udio) and media from any AI agent. Returns a verdict, AI-probability score, confidence, and provenance signals (Content Credentials / SynthID), plus scancatalog to audit a whole music folder.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "songcheck-mcp": {
    "command": "npx",
    "args": ["-y","afghanfansmedia-ai-songcheck-mcp"],
    "env": {
      "SONGCHECK_KEY": "",
      "SONGCHECK_API": ""
    }
  }
}
```

**Requires environment variables:** `SONGCHECK_KEY`, `SONGCHECK_API` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What afghanfansmedia-ai/songcheck-mcp MCP server does

The afghanfansmedia-ai/songcheck-mcp MCP server connects an MCP-compatible agent to the SongCheck detection service. It is intended for questions such as whether an audio track was generated by an AI music system, including systems such as Suno or Udio. The service can also assess images and video for AI content.

Music analysis produces a categorical result: likely AI-generated, uncertain, or likely human. The response also includes an AI-probability percentage, a confidence value, provenance indicators, and possible generator hints. Provenance checks can report Content Credentials or SynthID signals when those are present.

## How it works

The MCP process receives a file path through an exposed tool and sends the selected file to the SongCheck API for analysis. The default backend is `https://agencrew.com/sc-api`, but another backend can be selected with `SONGCHECK_API`. Results are returned to the calling agent rather than requiring the developer to interact with the service directly.

The service is described as a self-hosted v9-ensemble detector powered by SongCheck from Khaled Media. Despite the local MCP configuration, media files are uploaded to the SongCheck API. The README states that files are not retained beyond the detection log.

## Setup and configuration

Install the MCP command-line dependency and HTTP client with:

```bash
pip install "mcp[cli]" requests
```

Then register the Python MCP script in the agent's MCP configuration. The documented Claude Desktop configuration uses `python` as the command and points its arguments to the absolute path of `songcheck_mcp.py`. Restart the agent after adding the entry.

Two environment variables affect service access:

- `SONGCHECK_API` changes the SongCheck backend; the documented default is `https://agencrew.com/sc-api`.
- `SONGCHECK_KEY` supplies the subscription API key.

The free service allows five checks per day. A subscription key enables unlimited use, and the README states that batch or whole-catalog scans require a subscription key.

## Tools and capabilities

The afghanfansmedia-ai/songcheck-mcp MCP server exposes four tools:

- `detect_ai_music(file_path)` analyzes an audio file and returns the music verdict, probability, confidence, provenance signals, and generator hints.
- `detect_ai_media(file_path)` evaluates an image or video for AI content.
- `scan_catalog(folder_path)` checks an entire music folder and reports which tracks appear to be AI-generated.
- `songcheck_health()` checks the service status.

These tools allow an agent to handle one file at a time or perform a broader audit of a music directory.

## Limitations and notes

The detector is tuned for AI-generated music. A synthetic voice clip without accompanying music may receive a low AI assessment because AI-voice mode is not yet available. Analysis depends on the remote SongCheck service, so the configured backend must be reachable and the file must be suitable for upload.

The standard free allowance is limited to five checks per day. Once that allowance is exhausted, the service returns a subscription message. Whole-catalog scanning is not available without a subscription key. The documentation explicitly shows Claude Desktop configuration; it does not provide setup details for other clients.

_Full upstream README: https://allmcps.com/mcp/afghanfansmedia-ai-songcheck-mcp/readme_