flat-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FLAT_EXPORT_DIR | No | Diretório onde as exportações serão salvas. Opcional; o padrão é a pasta Downloads. | |
| FLAT_ACCESS_TOKEN | Yes | Token pessoal da API do Flat.io, com escopos scores, collections e account.public_profile. Obrigatório para autenticar o servidor. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| flat_whoamiA | Mostra a conta Flat autenticada pelo token (teste de conexão). |
| flat_list_collectionsB | Lista as coleções (pastas) da conta. |
| flat_list_scoresB | Lista partituras. collection: 'allScores' (todas), 'collaborations', 'trash' ou o id de uma coleção. sort: modificationDate | creationDate | title. Use 'next_cursor' do resultado para a próxima página. |
| flat_find_scoreC | Procura partituras da conta cujo título/compositor contenha o texto (sem diferenciar maiúsculas). |
| flat_score_overviewC | Metadados + estrutura musical (partes, ids, nº de compassos, armadura e compasso iniciais). |
| flat_get_measuresA | Devolve o MusicXML dos compassos nas posições start..end (1-based, inclusivo). Sem part_id, traz o trecho de todas as partes. Prefira trechos de até ~16 compassos. |
| flat_get_musicxmlC | MusicXML bruto da partitura, paginado por caracteres (use offset para continuar). |
| flat_list_revisionsB | Histórico de revisões (id, data, descrição) — útil para desfazer edições. |
| flat_exportB | Exporta e salva no computador. fmt: xml, mxl, midi, mp3, wav, pdf, png, json. Pasta padrão: FLAT_EXPORT_DIR ou ~/Downloads. |
| flat_replace_measuresC | Substitui compassos inteiros de uma parte (casando pelo atributo number) e grava nova revisão. measures_xml: um ou mais ... completos, já editados. description: o que mudou (fica no histórico do Flat). |
| flat_edit_musicxmlA | Edita por substituição exata de texto no MusicXML e grava nova revisão. edits: [{"find": "...", "replace": "...", "count": 1}] — 'count' é o nº EXATO de ocorrências esperadas (padrão 1); se não bater, nada é gravado. Útil para título, letra, dinâmicas, andamento. |
| flat_upload_revisionB | Substitui a partitura inteira por um MusicXML completo (texto ou arquivo .musicxml/.xml/.mxl/.mid local), gravando como nova revisão. |
| flat_restore_revisionB | Desfaz edições: copia o conteúdo de uma revisão antiga para uma nova revisão (o histórico é mantido). |
| flat_update_metadataB | Altera metadados da partitura no Flat (título, compositor, descrição...). privacy: private | public | privateLink. Tornar pública exige confirmação explícita do usuário. |
| flat_create_scoreB | Cria uma partitura nova (privada por padrão) a partir de MusicXML em texto ou de um arquivo local (.musicxml, .xml, .mxl, .mid). |
| flat_fork_scoreC | Duplica uma partitura (útil para editar uma cópia e preservar a original). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
The four write paths (flat_upload_revision, flat_replace_measures, flat_edit_musicxml, flat_restore_revision) all produce new revisions but operate at clearly different granularities (whole score, measure range, exact text substitution, revert), and the descriptions spell this out. The only mild overlaps are flat_get_measures vs flat_get_musicxml and flat_score_overview vs flat_get_musicxml, which are differentiated by range/pagination.
Almost every tool follows a flat_verb_noun pattern in snake_case (flat_create_score, flat_list_scores, flat_replace_measures), which is highly predictable. The lone deviation is flat_score_overview being noun-first, plus flat_whoami which lacks a noun but is a recognizable idiom.
16 tools is slightly on the heavy side but each maps to a plausible, non-redundant operation in a music-score editing lifecycle (read, edit, history, export, account). Nothing feels padded, though the set could be tightened by merging the two MusicXML getters.
Create, read (overview, measures, raw XML), update (metadata, measures, text, whole-score), fork, revision history/restore, and multi-format export are all covered, so most workflows reach no dead end. The notable gap is deletion/trashing of scores (the 'trash' collection is listed but no tool moves a score there) and collaboration management.