# HumMatch (remote · hummatch.me)

Match singers to songs by vocal range: score fit, karaoke difficulty, and voice type.

- Trust score: 69/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `hummatch.me`: 69/100 (this document), [markdown](https://verifymcp.io/servers/me-hummatch-hummatch/api-mcp.md), [page](https://verifymcp.io/servers/me-hummatch-hummatch/api-mcp)

## Channel facts

- Endpoint: `https://hummatch.me/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 74/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 69/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 840 tokens (~168/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 7/100
  - Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### Claude

```bash
claude mcp add --transport http me-hummatch-hummatch https://hummatch.me/api/mcp
```

### Codex

```toml
[mcp_servers.me-hummatch-hummatch]
url = "https://hummatch.me/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "me-hummatch-hummatch": {
      "type": "remote",
      "url": "https://hummatch.me/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add me-hummatch-hummatch --url https://hummatch.me/api/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  me-hummatch-hummatch:
    url: "https://hummatch.me/api/mcp"
```

### Other

```json
{
  "mcpServers": {
    "me-hummatch-hummatch": {
      "type": "http",
      "url": "https://hummatch.me/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 69, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-08-01 (score 68)

First indexed and scored.

## MCP tools (5)

### `get_vocal_profile` (~144 tokens)

Build a vocal profile

Turn a singer's vocal range into a normalized HumMatch vocal profile: a persistent Vocal ID, voice type, and tone label. Call this first when you know someone's range and want a profile to reuse across the other HumMatch tools.

Input parameters:

- `rangeHigh` (string, required): Highest comfortable note, as a note name like "C5" or a raw MIDI number.
- `rangeLow` (string, required): Lowest comfortable note, as a note name like "D3" or a raw MIDI number.
- `voiceType` (string): Optional voice type hint (soprano, mezzo, alto, tenor, baritone, bass). Inferred from the range when omitted.

### `recommend_songs` (~195 tokens)

Find songs that fit a voice

Rank the HumMatch catalog for one singer and return the songs they can actually sing, scored for range fit, karaoke difficulty, and voice-type suitability. Call this when someone asks what they should sing, what suits their voice or range, or wants karaoke song suggestions. Returns a ranked list plus named buckets (safest picks, easy wins, crowd pleasers, songs to avoid).

Input parameters:

- `limit` (integer): How many songs to return per bucket (default 12, max 50).
- `rangeHigh` (string, required): Highest comfortable note, as a note name like "C5" or a raw MIDI number.
- `rangeLow` (string, required): Lowest comfortable note, as a note name like "D3" or a raw MIDI number.
- `voiceType` (string): Optional voice type hint (soprano, mezzo, alto, tenor, baritone, bass). Inferred from the range when omitted.

### `search_songs` (~154 tokens)

Search the song catalog

Search HumMatch by song title or artist. Use this to resolve a song someone named into the catalog slug that check_song_fit needs, or to look up a song's measured vocal range. Pass rangeLow/rangeHigh as well to score every result against that voice and get the hits ranked by fit.

Input parameters:

- `limit` (integer): Maximum results (default 20, max 50).
- `q` (string, required): Search text: a song title, an artist, or both.
- `rangeHigh` (string): Optional. Highest note of the singer, to score and rank the results by fit.
- `rangeLow` (string): Optional. Lowest note of the singer, to score and rank the results by fit.

### `check_song_fit` (~167 tokens)

Score one song for a voice

Score a specific catalog song against a singer's range and explain why it fits or does not, including a suggested key to transpose to. Call this when someone asks whether they can sing a particular song. Resolve the song with search_songs first to get its slug.

Input parameters:

- `rangeHigh` (string, required): Highest comfortable note, as a note name like "C5" or a raw MIDI number.
- `rangeLow` (string, required): Lowest comfortable note, as a note name like "D3" or a raw MIDI number.
- `slug` (string, required): The catalog slug of the song, from search_songs.
- `voiceType` (string): Optional voice type hint (soprano, mezzo, alto, tenor, baritone, bass). Inferred from the range when omitted.

### `group_song_fit` (~79 tokens)

Find songs a group can sing together

Given two or more singers' ranges, find the vocal range they share and the songs that sit inside it. Call this for karaoke night with friends, a duet, a choir or worship team, or any "what can we all sing" question.

Input parameters:

- `profiles` (array, required): Two or more singers, each with a rangeLow and rangeHigh.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/me-hummatch-hummatch/api-mcp#diagnostics

## Score history

- 2026-08-03: 69
- 2026-08-02: 69
- 2026-08-01: 68

## Links

- Remote endpoint: https://hummatch.me/api/mcp
- Repository: https://github.com/Equitymind/HumMatch
- Website: https://hummatch.me/
- Changelog RSS feed: https://verifymcp.io/servers/me-hummatch-hummatch/api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/me-hummatch-hummatch/api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/me-hummatch-hummatch/api-mcp