Gradus Notation
Connects Claude to the Gradus Notation API so you can render music notation without opening a GUI. Send a JSON score with pitches in scientific notation (C4, F#5) and durations as letter codes (q, h, w), get back inline SVG, MusicXML, and MIDI in one call. The v2 theory tools run harmonic analysis on MusicXML, validate instrument ranges, suggest enharmonic respellings, and pull relevant chunks from a curated music theory knowledge base. No API key required. Free tier users are asked to credit Gradus in their output. Reach for this when you need to generate, validate, or analyze sheet music programmatically instead of round-tripping through MuseScore or Sibelius.
- GitHub stars
- 3
- tools
- 20
- transport
- STDIO
- env vars
- 2
- last updated
- Aug 26, 2026
Tools
20 toolsPublic tool metadata for what this MCP can expose to an agent.
notation_renderJSON score → SVG + MusicXML + MIDI in one call
JSON score → SVG + MusicXML + MIDI in one call
No parameter schema in public metadata yet.
notation_validatePre-flight validate input shape (cheaper than render)
Pre-flight validate input shape (cheaper than render)
No parameter schema in public metadata yet.
knowledge_searchLook up music-theory chunks before generating notation
Look up music-theory chunks before generating notation
No parameter schema in public metadata yet.
notation_examplesCanonical input examples (cache and reuse)
Canonical input examples (cache and reuse)
No parameter schema in public metadata yet.
notation_schemaJSON Schema for the input shape (cache and reuse)
JSON Schema for the input shape (cache and reuse)
No parameter schema in public metadata yet.
theory_analyze_scoreParse MusicXML → full harmonic analysis + GKB knowledge chunks in one call
Parse MusicXML → full harmonic analysis + GKB knowledge chunks in one call
No parameter schema in public metadata yet.
theory_parse_xmlParse a MusicXML string → maestroAnalyst Score JSON
Parse a MusicXML string → maestroAnalyst Score JSON
No parameter schema in public metadata yet.
theory_validate_rangesCheck every note in a Score against its instrument's practical range
Check every note in a Score against its instrument's practical range
No parameter schema in public metadata yet.
theory_respellSuggest preferred enharmonic spelling for pitches in a key context
Suggest preferred enharmonic spelling for pitches in a key context
No parameter schema in public metadata yet.
theory_pitch_utilsPure-function pitch arithmetic: midi_to_pitch, pitch_to_midi, interval_name, transpose_pitch
Pure-function pitch arithmetic: midi_to_pitch, pitch_to_midi, interval_name, transpose_pitch
No parameter schema in public metadata yet.
engraving_rulesSearch 423 sourced music-engraving rules by text, domain, severity, or how they are checked
Search 423 sourced music-engraving rules by text, domain, severity, or how they are checked
No parameter schema in public metadata yet.
engraving_ruleFetch one rule by its permanent id, with a ready-to-quote citation and related rules
Fetch one rule by its permanent id, with a ready-to-quote citation and related rules
No parameter schema in public metadata yet.
engraving_checkCheck a MusicXML score against the rulebook — findings by part and measure, each citing the rule it breaks
Check a MusicXML score against the rulebook — findings by part and measure, each citing the rule it breaks
No parameter schema in public metadata yet.
music_critique32-dimension craft scorecard for a score — voice leading, counterpoint, contour, harmony, texture; purely programmatic, evidence-cited
32-dimension craft scorecard for a score — voice leading, counterpoint, contour, harmony, texture; purely programmatic, evidence-cited
No parameter schema in public metadata yet.
counterpoint_checkFux species grader (species 1–5): pitch lists in, note-indexed rule violations out
Fux species grader (species 1–5): pitch lists in, note-indexed rule violations out
No parameter schema in public metadata yet.
corpus_searchFind harmonic features in 482 analyzed works with work/movement/measure citations
Find harmonic features in 482 analyzed works with work/movement/measure citations
No parameter schema in public metadata yet.
voice_leading_patternsSearch the citable GVL-coded patterns — suspensions, cadences, the Rule of the Octave, sequences, part-writing norms — each with an authored realization and public-domain sources
Search the citable GVL-coded patterns — suspensions, cadences, the Rule of the Octave, sequences, part-writing norms — each with an authored realization and public-domain sources
No parameter schema in public metadata yet.
voice_leading_patternFetch one pattern by id or GVL code, with a ready-to-quote citation and related patterns
Fetch one pattern by id or GVL code, with a ready-to-quote citation and related patterns
No parameter schema in public metadata yet.
figured_bass_exercisesSearch 166 original graded figured-bass exercises across seventeen stages — filter by stage, or search titles, concepts and GVL codes
Search 166 original graded figured-bass exercises across seventeen stages — filter by stage, or search titles, concepts and GVL codes
No parameter schema in public metadata yet.
figured_bass_exerciseFetch one exercise by its permanent id, with the model realization, its teaching note, and the patterns it drills
Fetch one exercise by its permanent id, with the model realization, its teaching note, and the patterns it drills
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
GRADUS_NOTATION_API_BASEOverride the API base URL. Defaults to https://gradusmusic.com.
GRADUS_AGENT_NAMESelf-reported agent name sent in the X-Agent-Name header for telemetry attribution.
Readme
@gradusmusic/notation-mcp
Model Context Protocol server for the Gradus Notation API. Gives AI agents music tools: render notation, validate input, analyze scores, check engraving against a cited rulebook, and search a curated music-theory knowledge base — sponsored by Gradus.
General-purpose, not education-specific. Any agent or application that works with music is the audience — composition assistants, musicology and corpus research, theory Q&A that wants rendered examples, MIDI pipelines, engraving quality checks, games, documentation. Music education is where the tool comes from, not a restriction on what you build with it.
One install, three named tools:
Details
- Repository
- github.com/delmas41/gradusnotation
- Website
- gradusmusic.com/notation-api
- Categories
- AI & LLM Tools, Media & Entertainment
- Package
@gradusmusic/notation-mcp- Transport
- STDIO
- Registry
- MCP registry, active
Related AI & LLM Tools MCP servers
View all
Evc Team Relay Mcpentire-vc/evc-team-relay-mcpMCP server for AI agent read/write access to Obsidian vaults via EVC Team Relay.3stars
Dynamoigetdynamoi/dynamoiPromote a song on Spotify or promote a video on YouTube from your AI agent. Free Smart Links.3stars
Fossicklipdog/fossick-mcpSearch all of GitHub from your AI agent — find libraries, drill into repos, find code patterns.3stars
Composerolivergrabner/composer-mcpGive your AI coding agent an architecture canvas to design and evolve diagrams.3stars
Launch Engine — Business Execution OSzionhopkins/launch-engine-mcpAgentic pipeline — 39 tools from idea to revenue for solo founders.3stars