# Clef Music Tools MCP server

For AI agents: the site index is at https://clefdrills.com/llms.txt and the HTML version of this page is at https://clefdrills.com/docs/mcp.

Music theory helpers for piano players: transpose chord charts, spell any chord as piano notes with MIDI numbers, turn guitar tab into piano pitches, and find Clef guides on converting music between formats.

- Endpoint: `https://clefdrills.com/mcp`
- Transport: Streamable HTTP (remote server, no install)
- Auth: none
- Tools: `transpose_chords`, `spell_piano_chord`, `tab_to_piano_notes`, `find_music_guides` (all read-only)
- Server card: [/.well-known/mcp/server-card.json](https://clefdrills.com/.well-known/mcp/server-card.json)
- Support: support@clefdrills.com

## Pages in this guide

- [Connect a client](https://clefdrills.com/docs/mcp/connect): Claude, ChatGPT, Cursor, VS Code, generic config and a curl check
- [transpose_chords](https://clefdrills.com/docs/mcp/tools/transpose-chords): Move a chord chart up or down by semitones, including slash bass notes.
- [spell_piano_chord](https://clefdrills.com/docs/mcp/tools/spell-piano-chord): List the notes of one chord symbol as piano pitches with octave and MIDI number.
- [tab_to_piano_notes](https://clefdrills.com/docs/mcp/tools/tab-to-piano-notes): Convert six-string ASCII guitar tab to sounding piano pitches, one event per tab column.
- [find_music_guides](https://clefdrills.com/docs/mcp/tools/find-music-guides): Find Clef guides by words in the title and description.
- [Limits and privacy](https://clefdrills.com/docs/mcp/limits-and-privacy): what the tools cannot do, input limits, privacy

## Quick start

Claude Code:

```bash
claude mcp add --transport http clef-music-tools https://clefdrills.com/mcp
```

Cursor, and any client that reads `mcpServers`:

```json
{
  "mcpServers": {
    "clef-music-tools": {
      "url": "https://clefdrills.com/mcp"
    }
  }
}
```

Other clients are covered on the [connect page](https://clefdrills.com/docs/mcp/connect).

## Example

Transpose a chord chart up two semitones with [transpose_chords](https://clefdrills.com/docs/mcp/tools/transpose-chords):

```bash
curl -s https://clefdrills.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"transpose_chords","arguments":{"chords":"C G/B Am F","semitones":2}}}'
```

Result:

```json
{ "chords": "D A/C# Bm G", "browserTool": "https://clefdrills.com/tools/chord-transposer/" }
```

## Limits and privacy

The tools take text only: no audio, PDFs, MusicXML or uploaded files. They are read-only, need no account and do not store what you send. Details are on the [limits and privacy page](https://clefdrills.com/docs/mcp/limits-and-privacy).

## Support

Email support@clefdrills.com. More help on the [support page](https://clefdrills.com/support/).
