Tools Overview

encoding-music-mcp provides a suite of tools for analyzing MEI files. All tools work with the built-in MEI collection.

Available Tools

Tool	Purpose	Learn More
`list_available_mei_files`	Browse and discover the 46 built-in MEI files	Documentation

Tool	Purpose	Learn More
`get_mei_metadata`	Extract title, composer, editors, dates, and copyright info	Documentation

Tool	Purpose	Learn More
`analyze_key`	Detect musical key with confidence scores	Documentation
`get_notes`	Extract all notes with pitch and octave information	Documentation
`get_melodic_intervals`	Analyze melodic intervals within voices	Documentation
`get_harmonic_intervals`	Analyze harmonic intervals between voices	Documentation
`get_melodic_ngrams`	Find recurring melodic patterns	Documentation

Tools for exploring the MEI collection:

Tools for extracting descriptive information:

Tools for analyzing musical content:

analyze_key: Key detection using music21
Interval Analysis: Comprehensive interval analysis using CRIM Intervals
- Notes extraction
- Melodic intervals
- Harmonic intervals
- N-gram pattern matching

All tools in encoding-music-mcp follow these principles:

Tools read directly from disk with no intermediate caching, ensuring:

All tools return structured dictionaries with consistent keys:

{
    "filename": "Bach_BWV_0772.mei",  # Always included
    "key_name": "...",                 # Tool-specific data
    # ...
}

Tools provide clear error messages when files don't exist or can't be processed:

FileNotFoundError: Could not load MEI file: nonexistent.mei

Analysis tools return data in readable tabular format:

Most tools accept a filename parameter:

filename: str  # Name of the MEI file (e.g., "Bach_BWV_0772.mei")

Analysis tools may accept additional parameters:

n: int  # For ngrams: length of patterns (default: 4)

Simply ask your AI assistant in natural language:

MCP clients can also invoke tools directly:

{
  "tool": "get_mei_metadata",
  "arguments": {
    "filename": "Bach_BWV_0772.mei"
  }
}