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 |
Capabilities
Features and capabilities supported by this server
| 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 | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/seajaysec/ireal-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server