# Gradus Notation MCP server

Agent View of the PolicyLayer registry record for Gradus Notation: identity, probed posture, risk grade, and all 10 tools classified. HTML page: https://policylayer.com/tools/com-gradusmusic-notation

## Facts

- Server id: `@gradusmusic/notation-mcp`
- Install: `npx -y @gradusmusic/notation-mcp`
- Homepage: https://github.com/delmas41/gradusnotation
- Registry record: grade C, identity unverified
- Lifecycle: active
- Rate-limited: no
- Tools: 10 (8 with introspected schema)
- Tool categories present: Execute, Read, Write
- Context-window cost: 5767 tokens per request — https://policylayer.com/token-cost/com-gradusmusic-notation
- Tags: com gradusmusic notation, automation
- Record last modified: 2026-08-26T04:20:39.424Z

## Tools (10)

| Tool | Category | Risk | Record |
| --- | --- | --- | --- |
| `knowledge_search` | Read | Low | https://policylayer.com/tools/com-gradusmusic-notation/knowledge-search.md |
| `notation_examples` | Read | Low | https://policylayer.com/tools/com-gradusmusic-notation/notation-examples.md |
| `notation_render` | Read | Low | https://policylayer.com/tools/com-gradusmusic-notation/notation-render.md |
| `notation_schema` | Read | Low | https://policylayer.com/tools/com-gradusmusic-notation/notation-schema.md |
| `notation_validate` | Read | Low | https://policylayer.com/tools/com-gradusmusic-notation/notation-validate.md |
| `theory_analyze_score` | Read | Low | https://policylayer.com/tools/com-gradusmusic-notation/theory-analyze-score.md |
| `theory_parse_xml` | Read | Low | https://policylayer.com/tools/com-gradusmusic-notation/theory-parse-xml.md |
| `theory_pitch_utils` | Read | Low | https://policylayer.com/tools/com-gradusmusic-notation/theory-pitch-utils.md |
| `theory_respell` | Read | Low | https://policylayer.com/tools/com-gradusmusic-notation/theory-respell.md |
| `theory_validate_ranges` | Read | Low | https://policylayer.com/tools/com-gradusmusic-notation/theory-validate-ranges.md |

## Tool descriptions

- `knowledge_search` — Search the Gradus music-theory knowledge base for authoritative source material. The corpus includes hand-authored curriculum prose, Bach chorale analysis (408 chorales), score commentaries on 50+ orchestral works, and primary historical…
- `notation_examples` — Fetch six canonical example inputs covering the most common notation_render use cases: single-line melody, two-voice counterpoint (cantus firmus + counterpoint), block-chord progression (cadence), mixed rhythms with dynamics + articulati…
- `notation_render` — Render music notation from a JSON score into three output formats in a single call: inline SVG (engraved through Verovio with the Bravura SMuFL font — same engine as IMSLP and the Music Encoding Initiative), round-trippable MusicXML (ope…
- `notation_schema` — Fetch the JSON Schema (Draft 2020-12) describing the notation_render input shape. Includes every field, its type, defaults, validation rules (including the shorthand-string regex pattern), and $defs for Instrument, VoiceLine, Note, and N…
- `notation_validate` — Pre-flight validate a notation_render input without rendering. Returns errors with concrete fix field that tells the agent exactly how to repair malformed input. Substantially cheaper than notation_render because it skips the Verovio eng…
- `theory_analyze_score` — One-shot endpoint: parse MusicXML → run the full MaestroAnalyzer harmonic analysis pipeline → query the Gradus Knowledge Base (GKB) for curated theory chunks matched to the score's detected features. Returns both the algorithmic analysis…
- `theory_parse_xml` — Parse a MusicXML string into a maestroAnalyst Score object. The Score is the input type for theory_validate_ranges and can be passed to any maestroAnalyst analysis function. WHEN TO USE: when you have a MusicXML file (e.g., exported from…
- `theory_pitch_utils` — A collection of fast, pure pitch-utility operations that replace the most-used music21 pitch functions with zero network round-trip. OPERATIONS: midi_to_pitch — MIDI number → pitch string. midi=60 → "C4". preferFlats=true → "Db" spelling…
- `theory_respell` — Suggest the preferred enharmonic spelling for one or more pitches in a given key context. Picks the spelling that is diatonic to the key (e.g. F# in G major, Gb in F major). Uses the key's accidental preference (sharps/flats) as a tiebre…
- `theory_validate_ranges` — Check every note in a Score JSON against its instrument's standard practical range. Returns warnings for out-of-range pitches with measure, beat, MIDI number, and severity. WHEN TO USE: after parsing a MusicXML file with theory_parse_xml…

## Related servers

- UnClick (1662 tools) — https://policylayer.com/tools/io-github-malamutemayhem-unclick-mcp-server.md
- Delx Protocol — Agent Recovery & Continuity (1076 tools) — https://policylayer.com/tools/io-github-davidmosiah-delx-protocol.md
- Delx Mcp A2a (1068 tools) — https://policylayer.com/tools/io-github-davidmosiah-delx-mcp-a2a.md
- MCP Framework Personal (912 tools) — https://policylayer.com/tools/inggerman-mcps.md
- Nodebench (824 tools) — https://policylayer.com/tools/io-github-homenshum-nodebench.md
- Delx MCP Server (740 tools) — https://policylayer.com/tools/io-github-davidmosiah-delx-mcp-server.md
- Binance MCP Server (734 tools) — https://policylayer.com/tools/nirholas-binance-mcp.md
- Crawlora (728 tools) — https://policylayer.com/tools/crawlora-mcp.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=com-gradusmusic-notation · API: https://policylayer.com/registry/api · Recommended policies for every tool: https://policylayer.com/policies/com-gradusmusic-notation
