ireal-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IREAL_PORT | No | Port for the HTTP server | 1357 |
| IREAL_LIBRARY | No | Directory for the chart library | ~/.ireal-mcp/charts |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_chartA | Build an iReal Pro chord chart from structured measures (or a raw progression). Every measure is padded to a fixed cell width so iReal Pro wraps to exactly |
| preview_chartA | Render only the ASCII layout grid for a chart (measuresPerLine per row) without building the import links. Fast way to check the 4-bars-per-line layout while iterating on chords. |
| decode_chartA | Parse an existing irealb:// or irealbook:// URL (or HTML containing one) back into its title, composer, style, key, the raw progression, and a best-effort measure list — useful for editing an existing chart. |
| list_stylesA | List the built-in iReal Pro play-along styles, grouped by family (Jazz / Latin / Pop). |
| list_chord_qualitiesA | List the chord roots, qualities, time signatures, and key signatures iReal Pro understands, so generated charts use valid symbols. Chord = root + quality + optional /bass (e.g. C-7/Bb). |
| analyze_chartA | Harmonic analysis to help plan a solo: Roman numerals, chord function, a chord-scale recommendation per chord (with the actual scale notes), detected ii–V(–I) cells, and a short jam plan. Pass |
| list_chartsA | List all charts in the on-disk library, with their slugs and served URLs. |
| delete_chartA | Remove a chart from the library by slug (deletes its .json and .html). |
| server_infoA | Report the library directory, the configured port, and the LAN URLs where the chart server is (or will be) reachable from other devices. Also gives the command to start the server. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| chart_song | Research a song's real chords and create BOTH a straight chart and an embellished chart, saved to the library and served over HTTP. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool targets a distinct operation: creating, analyzing, decoding, deleting, listing charts, querying chord qualities/styles, previewing layout, and server info. No functional overlap.
All tool names follow a consistent verb_noun snake_case pattern (e.g., analyze_chart, list_charts, list_styles). No mixing of conventions.
9 tools cover the core workflow of iReal Pro chart management without being excessive. Each tool serves a clear purpose, and the count is well-scoped.
The tool set covers create, read (list, decode, preview), analyze, and delete. A minor gap is the lack of an update/edit tool, requiring delete+create for modifications.