# PitchHighway MCP server

Source: https://pitchhighway.com/mcp
Site: PitchHighway — learn to sing your favorite songs (https://pitchhighway.com)

## What it is

PitchHighway is an MCP (Model Context Protocol) server. A user connects their PitchHighway account once, and their AI assistant can then read their measured vocal range, the songs they uploaded, their practice scores, their journey progress and their note-level pitch reports — and coach them against real data instead of guesses.

Every tool is read-only and takes no arguments. MCP can read a user's training data, never change it. No audio ever leaves the user's device through MCP: pitch detection runs on-device and this server exposes only the computed metrics — never a recording, stem or audio file.

## Server URL

https://pitchhighway.com/mcp  (https://pitchhighway.com/api/mcp is the same server on its original URL and keeps working)

Opening https://pitchhighway.com/mcp in a browser serves the human-readable setup documentation; an MCP client POSTs JSON-RPC to the same URL.

## Connecting

Claude (web / desktop):

1. Settings → Connectors → Add custom connector
2. Paste https://pitchhighway.com/mcp
3. Claude opens the PitchHighway sign-in — log in and approve
4. Ask Claude about your singing

Claude Code:

1. Run: claude mcp add --transport http pitchhighway https://pitchhighway.com/mcp
2. The first call opens the PitchHighway sign-in in the browser; approve it once

Codex CLI:

1. Run: codex mcp add pitchhighway --url https://pitchhighway.com/mcp
2. Run: codex mcp login pitchhighway — adding an OAuth-protected server does not start the sign-in, the second command does

ChatGPT:

1. Settings → Apps & Connectors → turn on Developer mode
2. Create a connector with the server URL https://pitchhighway.com/mcp
3. Keep OAuth as the authentication method
4. Accept the warning, create the connector, then connect and sign in

Other MCP clients (Cursor, Zed, and anything else that speaks MCP):

1. Add an MCP server with transport `http` (streamable HTTP) and the URL https://pitchhighway.com/mcp
2. Complete the OAuth sign-in

Advanced alternative to OAuth: generate a personal access token in the web app (Home → the Connect banner → Advanced) and send it in a request header named `authorization`.

## Tools

- `list_songs` — Every song the user has uploaded: title, whether it finished processing, and whether a learning journey exists for it.
- `get_voice_profile` — The user's measured vocal range (lowest and highest note, span in semitones) and their Sing in Original Key setting.
- `get_progress` — Practice streak, journey level, scores and weekly activity.
- `get_voice_analysis` — Last 7 days vs. the week before: per-category scores out of 100, range trend, practice volume — each with the number of attempts behind it.
- `get_coaching_context` — Where the user is right now: current journey, the node they are up to, their weakest passage, and their last ~10 drills.
- `get_last_song_evaluation` — Note-level pitch report for the most recent full-song run: on-pitch rate, sharp/flat tendency in cents, steadiness, most-missed notes.
- `get_upload_quota` — Whether the user can upload a song right now, and how much of their allowance is left.
- `get_voice_check_report` — The user's latest "Check my voice" write-up, served from cache.

## Requirements

- A PitchHighway account — free to create at https://pitchhighway.com/register, in the browser or on iPhone/iPad.
- A Premium subscription for the MCP connection itself: https://pitchhighway.com/premium. Premium is checked on every request, so a lapsed subscription silently disables the connection and resuming it restores access immediately — nothing to reconfigure.
- An MCP-capable assistant that speaks streamable HTTP.
- All tools are read-only. No MCP tool uploads, renames, deletes, buys or cancels anything, and no audio is exposed.

## Protocol

- Transport: stateless Streamable HTTP — one POST in, one JSON response out. No SSE stream, no session id, no JSON-RPC batching.
- Messages: JSON-RPC 2.0. Protocol revision 2025-06-18.
- GET on the server URL returns the setup page to anything asking for text/html, and 405 to everything else. DELETE returns 405.
- Auth: OAuth 2.1 with mandatory PKCE S256 and dynamic client registration, or a personal access token in the `authorization` header.
- Discovery: https://pitchhighway.com/.well-known/oauth-protected-resource/mcp and https://pitchhighway.com/.well-known/oauth-authorization-server

## Links

**Setup page:** https://pitchhighway.com/mcp
**Sign up (free):** https://pitchhighway.com/register
**Premium:** https://pitchhighway.com/premium
**Machine-readable site index:** https://pitchhighway.com/llms.txt
**Support:** support@pitchhighway.com