# Connect to the 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/connect.

Clef Music Tools is a remote MCP server over Streamable HTTP. Nothing is installed and no key is needed: point a client at `https://clefdrills.com/mcp`.

## Claude Code

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

Check it with `claude mcp list`. The four tools appear under the server name `clef-music-tools`.

## Claude on the web and desktop

Open the connectors settings, add a custom connector (remote MCP server) and paste `https://clefdrills.com/mcp`. Leave authentication empty.

## ChatGPT

In a workspace or developer mode that allows custom connectors, add a connector with the MCP server URL `https://clefdrills.com/mcp` and no authentication.

## Cursor

Add this to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

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

## VS Code

Add this to `.vscode/mcp.json`:

```json
{
  "servers": {
    "clef-music-tools": {
      "type": "http",
      "url": "https://clefdrills.com/mcp"
    }
  }
}
```

## Any other client

Use the transport type `streamable-http` (some clients call it `http`) and the URL `https://clefdrills.com/mcp`. A client that reads the `mcpServers` format can use the Cursor snippet above.

## Check the connection with curl

Initialize:

```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":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'
```

The response names the server `clef-music-tools`, title `Clef Music Tools`, version `1.0.0`, and includes usage instructions for the client. List the tools:

```bash
curl -s https://clefdrills.com/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
```

The result lists `find_music_guides`, `transpose_chords`, `spell_piano_chord` and `tab_to_piano_notes`, each with its input schema.

## Transport details

- The server is stateless: every request is an independent POST with a JSON body and gets one JSON response. There are no sessions and no server-sent event streams, so a GET with `Accept: text/event-stream` returns 405.
- Send `Content-Type: application/json`. Other content types return 415.
- Request bodies are limited to 64 KB. Larger bodies return 413.
- A browser GET on `https://clefdrills.com/mcp` shows a short setup page.
- Server card: [/.well-known/mcp/server-card.json](https://clefdrills.com/.well-known/mcp/server-card.json).

## Related pages

- [transpose_chords](https://clefdrills.com/docs/mcp/tools/transpose-chords)
- [spell_piano_chord](https://clefdrills.com/docs/mcp/tools/spell-piano-chord)
- [tab_to_piano_notes](https://clefdrills.com/docs/mcp/tools/tab-to-piano-notes)
- [find_music_guides](https://clefdrills.com/docs/mcp/tools/find-music-guides)
- [Limits and privacy](https://clefdrills.com/docs/mcp/limits-and-privacy)
