Verified Human Server

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

License: MIT CI Python 3.10+ Code style: Ruff MCP Coverage Built by MusicTech Lab

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

Tool	Description
vhc_verify_isrc	Verify a certification by ISRC code
vhc_verify_track	Check certification status by artist + track name
vhc_verify_cert	Look up a certification by cert number
vhc_registry	List recently issued certifications
vhc_stats	Platform statistics (totals, tiers, counts)
vhc_pricing	Current pricing and bundle options

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

Variable	Purpose	Default
VHC_API_URL	Base URL for the VHC API	https://verifiedhumancert.com
VHC_API_TIMEOUT	HTTP request timeout in seconds	15.0
VHC_API_RETRIES	Max retry attempts on transient errors and 5xx	2
VHC_API_BACKOFF	Base delay (seconds) for exponential retry backoff	0.5
VHC_LOG_LEVEL	Server log level on stderr (DEBUG/INFO/WARNING/ERROR)	WARNING

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.

---