♩Clef:

Connect to the Clef Music Tools MCP server

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

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):

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

VS Code

Add this to .vscode/mcp.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:

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:

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.

Related pages