Skip to content
MCP server

Scoreproof

Convert MusicXML, MIDI, ABC, MEI and Humdrum and verify every note survived

Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally or Remotely
Version
0.2.0
Listing updated
today

Similar MCP servers

About Scoreproof

Scoreproof is an open-source MCP server for files and documents. It can run locally on your machine or as a hosted remote server.

Verification is what sets this converter apart: each conversion re-reads its own output, compares it note by note with the source and reports what was kept and what a format cannot hold, such as MIDI lacking chord symbols or lyrics layout. It also repairs quirks in exports from notation apps like Sibelius, Dorico, Finale, MuseScore and Guitar Pro, and turns played MIDI into readable notation by finding the beat, snapping rhythms and splitting piano into two hands.

Beyond conversion, the tools inspect a score, validate bars and ranges, compare two versions bar by bar even across formats, transpose by interval or key, extract parts or bars, and render PDF, PNG, SVG or a WAV preview. It never overwrites a file unless you give that exact output path. Native Sibelius, Dorico, Finale and MuseScore files are not supported; export MusicXML first.

The README reports a benchmark on 430 real exports, with 100% loading and 95.6% read faithfully against music21 alone at 87.9%. A hosted connector exists with a 10 MB file limit and 24-hour deletion, or run it locally with uvx. MIT licensed.

Install

Run in a terminal

claude mcp add --transport http scoreproof https://scoreproof-fkkuctjokq-uc.a.run.app/mcp

Add to Settings → Connectors → Add custom connector

https://scoreproof-fkkuctjokq-uc.a.run.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "scoreproof": {
      "url": "https://scoreproof-fkkuctjokq-uc.a.run.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "scoreproof": {
      "type": "http",
      "url": "https://scoreproof-fkkuctjokq-uc.a.run.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "scoreproof": {
      "serverUrl": "https://scoreproof-fkkuctjokq-uc.a.run.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "scoreproof": {
      "type": "http",
      "url": "https://scoreproof-fkkuctjokq-uc.a.run.app/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

convert
Convert a file and verify the result note by note, or make a PDF or PNG.
batch_convert
Convert many files or whole folders.
inspect
Summary of parts, ranges, key, meter and tempo with an ABC excerpt.
validate
Find bars that don't add up, out-of-range notes and repaired quirks.
compare
Bar-by-bar changes between two versions.
transpose
Transpose by interval, into a key or between concert and written pitch.
extract
Pull out parts or bars or make one file per player.
render
Sheet music as PDF, PNG or SVG, or a WAV preview.
list_formats
Formats and what each cannot hold.

What it does

Verified conversion
Compares output with source note by note and lists losses.
Exporter repairs
Fixes quirks from common notation apps.
MIDI to notation
Finds the beat, quantizes and splits piano hands.
Score comparison
Bar-by-bar differences across formats.
Transpose and extract
Change key or pull parts and bars.
Render
PDF, PNG, SVG and WAV preview.

Good for

  • Turn a played MIDI take into printable sheet music
  • Check a Sibelius export before sending to a copyist
  • Transpose a lead sheet to B-flat
  • Compare two draft versions of a score

Pricing

Open source

MIT licensed; hosted service is free with limits

Scoreproof FAQ

Which formats does it handle?

MusicXML, MIDI, ABC, MEI and Humdrum.

Can it read native Sibelius or Dorico files?

No; export MusicXML from the app first.

What are the hosted limits?

Per-address rate limits, a 10 MB file limit and files deleted after 24 hours.

What licence is it?

MIT.

Is Scoreproof free?

Yes. Scoreproof is open source, so you can use and self-host it for free.

How do I add Scoreproof to Claude Code?

Run this command in your terminal: claude mcp add --transport http scoreproof https://scoreproof-fkkuctjokq-uc.a.run.app/mcp

What are the best alternatives to Scoreproof?

The closest alternatives to Scoreproof are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers