Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
IREAL_PORTNoPort for the HTTP server1357
IREAL_LIBRARYNoDirectory for the chart library~/.ireal-mcp/charts

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 measuresPerLine measures per line (default 4). By default the chart is SAVED to the on-disk library and served by the standalone HTTP server (so it's reachable from other devices on the network). Returns a modern irealb:// import link, a legacy irealbook:// link, the served URLs, an ASCII layout preview, and validation warnings.

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 slug to analyze a saved chart, or pass key + measures to analyze inline.

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

NameDescription
chart_songResearch 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

NameDescription

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