Gradus Notation
Render and analyze music notation (SVG, MusicXML, MIDI) and query music theory from your agent while building apps, demos, or educational content.
Overview
Gradus Notation MCP is a Build-phase MCP server for integrations that renders and analyzes music notation and supports music-theory search via Gradus APIs.
What is this MCP server?
- Render notation to SVG, MusicXML, and MIDI via MCP tools backed by Gradus
- Analyze scores and search music theory without a separate GUI
- Free tier with no authentication required per registry description
- stdio npm package @gradusmusic/notation-mcp (version 0.2.2)
- Optional GRADUS_NOTATION_API_BASE and GRADUS_AGENT_NAME environment variables
- Package version 0.2.2
- Default API base https://gradusmusic.com (overridable via env)
- Auth: none required per registry description
Community signal: 1 GitHub stars.
What problem does it solve?
Agents cannot produce valid engraved notation or structured MusicXML without a dedicated music API bridge.
Who is it for?
Builders adding notation previews, export buttons, or theory helpers to web or agent-driven music products.
Skip if: Pro audio production, full DAW workflows, or teams that require enterprise licensing and SLA beyond the free no-auth model.
What do I get? / Deliverables
Your agent can generate SVG/MusicXML/MIDI and run theory-aware analysis inside the same session you code the feature.
- SVG, MusicXML, and MIDI notation artifacts from agent tool calls
- In-session score analysis and music-theory lookup results
- Integrated notation pipeline without a separate desktop engraver
Recommended MCP Servers
Journey fit
Notation rendering and theory lookup are implementation-time integrations when a product needs scores, exports, or musical UX—not launch SEO. Gradus is an npm stdio MCP package that wires agent workflows to an external notation API—classic build-phase agent tooling.
How it compares
Specialized notation API MCP, not a general LLM skill or browser automation server.
Common Questions / FAQ
Who is com.gradusmusic/notation for?
Developers and solo builders integrating engraved music output and theory lookup into apps or agent workflows.
When should I use com.gradusmusic/notation?
During Build when you need SVG, MusicXML, or MIDI from agent-driven composition or analysis features.
How do I add com.gradusmusic/notation to my agent?
Install @gradusmusic/notation-mcp via npm, configure stdio MCP in your client, and optionally set GRADUS_NOTATION_API_BASE.