# SongCheck MCP — AI music & media detection inside any AI agent

Detect AI-generated music (and images/video) straight from Claude, ChatGPT, Gemini, Grok, or GitHub Copilot. Ask in plain language:

> "Is this song AI-generated?"  ·  "Analyze this file for AI content."

Powered by **SongCheck** (Khaled Media) — a self-hosted v9-ensemble detector. Free: https://khaledmedia.com/songcheck

## Tools it exposes
- `detect_ai_music(file_path)` — audio → verdict (LIKELY AI-GENERATED / UNCERTAIN / LIKELY HUMAN), AI probability %, confidence, provenance (Content Credentials / SynthID), generator hints.
- `detect_ai_media(file_path)` — image or video → AI-detection assessment.
- `scan_catalog(folder_path)` — audit an ENTIRE music folder, report which tracks are AI.
- `songcheck_health()` — service status.

## Install (2 steps)
```
pip install "mcp[cli]" requests
```
Then add it to your agent's MCP config:

**Claude Desktop** (`claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "songcheck": {
      "command": "python",
      "args": ["/absolute/path/to/songcheck_mcp.py"]
    }
  }
}
```
Restart the agent. Now ask: *"Use SongCheck to tell me if ~/Downloads/track.mp3 is AI-generated."*

## Pricing
- **Free: 5 checks/day.** After that you'll get a "subscribe" message.
- **Unlimited: subscribe** at https://khaledmedia.com/songcheck — you receive an API key by email. Set it via `SONGCHECK_KEY` in the config `env`.
- Batch / whole-catalog scans require a subscription key.

## Notes
- Point at a different backend with `SONGCHECK_API` (default `https://agencrew.com/sc-api`).
- The detector is tuned for AI **music**; a bare synthetic-voice clip with no music may read low (AI-voice mode is on the roadmap).
- Privacy: the file is sent to the SongCheck API for analysis and not retained beyond the detection log.