Verified Human MCP Server

MCP server for querying the Verified Human Cert registry — verify human-made music certifications by ISRC, artist, track, or cert number.

What is Verified Human Cert?

Verified Human Cert is a registry that certifies music tracks as human-made. Artists and labels can register their tracks and receive a certification that proves the music was created by humans, not AI.

This MCP server lets Claude Code (and other MCP clients) query that registry directly.

Tools

Quick Start

Prerequisites

• Python 3.10+

• Poetry

Installation

poetry install

Running the server

poetry run python -m verified_human_mcp_server

Add to Claude Code

Use the claude mcp add CLI (recommended) — it writes to the correct config file for you:

# User scope (available in all projects)
claude mcp add vhc --scope user -- poetry --directory /path/to/verified-human-mcp-server run python -m verified_human_mcp_server

# Or project scope (committed to repo, shared with team via .mcp.json)
claude mcp add vhc --scope project -- poetry --directory /path/to/verified-human-mcp-server run python -m verified_human_mcp_server

Manual configuration

If you prefer to edit config files by hand, add an entry under mcpServers in one of:

• User scope — ~/.claude.json (not ~/.claude/settings.json — that file does not read mcpServers)

• Project scope — .mcp.json at the repo root (version-controlled, shared with the team)

{
  "mcpServers": {
    "vhc": {
      "type": "stdio",
      "command": "poetry",
      "args": ["--directory", "/path/to/verified-human-mcp-server", "run", "python", "-m", "verified_human_mcp_server"]
    }
  }
}

After editing, restart Claude Code (or run /mcp to reconnect) and verify with claude mcp list.

Environment Variables

Usage Examples

Once connected, you can ask Claude:

• "Is ISRC USHM82148308 certified as human-made?"

• "Check if 'Yesterday' by The Beatles has a VHC certification"

• "Look up cert number VH-2026-000001"

• "Show me the latest certified tracks"

• "What are the current VHC pricing tiers?"

Multi-agent workflow: metadata + verification

Combine with mcp-metadata to read ISRC codes from audio files and verify them automatically:

User: "Read the ISRC from song.flac and check if it's certified"

Agent 1 (mcp-metadata): metadata_read("song.flac") -> ISRC: USHM82148308
Agent 2 (verified-human-mcp-server): vhc_verify_isrc("USHM82148308") -> certified: true

Development

# Clone the repo
git clone https://github.com/verifiedhumancert/verified-human-mcp-server.git
cd verified-human-mcp-server

# Install dependencies
poetry install

# Run tests
poetry run pytest

# Run linter
poetry run ruff check .
poetry run ruff format --check .

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before submitting a PR.

Security

To report a vulnerability, please see SECURITY.md.

License

This project is licensed under the MIT License — see LICENSE for details.