Gradus Notation MCP Server

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. Its 10 documented tools cover theory, notation, validate. It runs locally over stdio via the published package.

People connecting security tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · ★ 2 · #44 OF 182 MAINTAINED SECURITY · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Gradus Notation

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add delmas41-gradusnotation -- npx -y @gradusmusic/notation-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "delmas41-gradusnotation": {
      "command": "npx",
      "args": [
        "-y",
        "@gradusmusic/notation-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @gradusmusic/notation-mcp - the @gradusmusic scope differs from the repo owner (delmas41); confirm it's the project's official package

registry vendor namespace com.gradusmusic - domain-verified with the official MCP registry

03 · What Gradus Notation can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can parse a MusicXML string → maestroAnalyst Score JSON, and check every note in a Score against its instrument's practical range.

Capability map

Tools grouped from the project's README - what Gradus Notation lets an agent do.

Theory

5 tools - e.g. Parse MusicXML → full harmonic analysis + GKB knowledge chunks in one call; Parse a MusicXML string → maestroAnalyst Score JSON; Check every note in a Score against its instrument's practical range

theory_analyze_score · theory_parse_xml · theory_validate_ranges · theory_respell · theory_pitch_utils

Notation

4 tools - e.g. JSON score → SVG + MusicXML + MIDI in one call; Pre-flight validate input shape (cheaper than render); Canonical input examples (cache and reuse)

notation_render · notation_validate · notation_examples · notation_schema

Knowledge

1 tool - e.g. Look up music-theory chunks before generating notation

knowledge_search

Latest releases

v0.1.1 · 2026-05-07

First public release of @gradusmusic/notation-mcp. · What it does · Model Context Protocol server for the Gradus Notation API. Lets AI agents render music notation, validate input, and search a curated music-theory…

04 · Who maintains Gradus Notation

Gradus Notation is maintained by delmas41. It's the only MCP server we track from this author; the repo dates to May 2026.

05 · Facts

repository: github.com/delmas41/gradusnotation
website: https://gradusmusic.com/notation-api
category: security - ranked #44 of 182 actively-maintained security servers as of 2026-08-25.
registry: com.gradusmusic/notation (active, first published 2026-05-19 · 9 versions)
packages: npm:@gradusmusic/notation-mcp

06 · Gradus Notation FAQ

Is Gradus Notation still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24. We re-verify nightly.

What can Gradus Notation do?

With this server connected, an agent can parse a MusicXML string → maestroAnalyst Score JSON, and check every note in a Score against its instrument's practical range.

How do I install Gradus Notation?

Run `npx -y @gradusmusic/notation-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Gradus Notation run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Gradus Notation

Alternatives to Gradus Notation

Maintained security servers if Gradus Notation isn't the fit.

Pairs well with

Servers that cover what Gradus Notation doesn't - only shown when the pairing reason fits the companion.

More security MCP servers · Open Work Proof · Dep Diff MCP · Screenshot · Envault · Conarium

More JavaScript MCP servers · Amendor · Process · GLM MCP · Guesty MCP Server · Twitterapi Docs MCP · see all