# Scoreproof

> Scoreproof is an open-source MCP server for files and documents. Convert MusicXML, MIDI, ABC, MEI and Humdrum and verify every note survived. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/asampat3090/scoreproof
- **MCP Registry name:** io.github.asampat3090/scoreproof
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://scoreproof-fkkuctjokq-uc.a.run.app/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Csv](https://ai-powered.com/mcp/csv): Csv is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/scoreproof
