§ Referência · Protocolo de Contexto do Modelo

As 33 ferramentas e o que cada uma faz.

Publicado em outubro de 2026

Esta é a tabela de ferramentas do servidor Doseedo MCP em https://api.doseedo.com/mcpEm prosa: 33 ferramentas em cinco famílias. O controle de sessão lê e edita uma sessão DAW (ao vivo no Logic Pro com Dø DesktopO Projects importa, converte e compila arquivos de projeto completos em dez formatos de DAW. O Audio and Music gera, separa e transcreve áudio. O Analysis responde a perguntas sobre tonalidade, andamento e acordes de forma síncrona e gratuita. A última família é a de encanamento: uploads, espera, custo. A versão legível por máquina é a placa de servidor, construído a partir da mesma matriz que o protocolo serve.

Como as ferramentas se encaixam

Três ferramentas funcionam antes mesmo de você fazer login — doseedo_recipes, doseedo_edit_ops_reference e doseedo_quote — porque eles não leem nenhuma conta e não gastam nada; um agente lê primeiro as receitas e o catálogo de operações e, em seguida, autentica-se em sua primeira chamada real. Os IDs são estáveis: os rastreamentos são t_…, suas tiras de mistura ch_…E todo o resto (parâmetros, marcadores, clipes) vem de uma leitura de sessão. As batidas são absolutas a partir do compasso 1; um fader em 0.709 é 0 dB. Cada tarefa longa retorna um job_id e é atendido com doseedo_wait_taskCada resultado é um link pré-assinado que funciona por 24 horas com um endereço IP simples. curle pode ser passado para a próxima ferramenta como entrada.

As chaves carregam escopos: uma chave completa, uma somente leitura chave (read:sessions — escreve a resposta 403 e o agente é informado sobre qual escopo ele precisa), e ops:<group> Teclas que permitem uma categoria de edição — mixer, regiões, plugins, faixas, projeto, marcadores, automação, histórico. Crie-as em Configurações → Chaves de APIAs concessões OAuth também aparecem lá.

Controle de sessão — leia e edite uma sessão de DAW

A família de softwares que torna o "controle da minha DAW" literal. Cada edição é salva na sessão na nuvem; com o Dø Desktop em execução, ela é aplicada ao projeto aberto Logic em segundos.

FerramentaO que faz
doseedo_list_sessionsAs sessões na conta conectada — IDs, nomes, DAW, última atualização — da mais recente para a mais antiga, paginadas com limit e offset.
doseedo_create_sessionUma nova sessão vazia: um projeto em branco que o agente preenche com edições ou define como alvo uma compilação.
doseedo_get_sessionUma sessão como um arranjo sobre o qual um agente pode raciocinar: cada faixa com seus IDs, regiões nas batidas. e segundos, níveis do mixer em dB, cadeias de plugins com IDs de parâmetros, tempo, fórmula de compasso, marcadores, a tonalidade quando conhecida — e sync.live_edits, a única resposta para "minha mudança vai funcionar?". Anotações são omitidas em sessões grandes, a menos que sejam solicitadas.
doseedo_edit_sessionUma lista de operações aplicadas em uma chamada atômica (até 500): mover e cortar regiões, reescrever notas MIDI, adicionar e excluir faixas, faders, panorâmica, silenciar, inserir plugins por nome, definir parâmetros, tempo, tonalidade, marcadores, submixar buses e roteamento, samples do Quick Sampler. Uma rejeição nomeia a operação, um código e um did_you_mean; um batch_key faz uma nova tentativa de desduplicação.
doseedo_edit_ops_referenceO catálogo de operações edit_session aceita — unidades, ids, receitas — servidas em visualizações que se encaixam em uma única resposta. AbrirNão é necessário apresentar credencial.
doseedo_download_sessionA sessão como nativo .logicx, reconstruído no servidor a partir do log de edição, sem necessidade de desktop. Retorna um link sem autenticação mais um replay relatório do que foi salvo e os comandos de cópia que colocam os arquivos locais de volta no projeto.
doseedo_bounce_sessionGrave faixas (ou a sessão inteira) em WAV ou AIFF através de suas respectivas cadeias de plugins, offline — o Dø Desktop renderiza em segundo plano sem precisar abrir a DAW.
doseedo_add_audio_to_sessionAdicione um arquivo de áudio a uma sessão — uma gravação pré-gravada, uma faixa separada, qualquer URL https ou um arquivo que você carregou — pronto para ser inserido em uma faixa.
doseedo_list_pluginsOs plugins que um agente pode inserir por nome incluem: o catálogo padrão Logic, além dos instrumentos e efeitos instalados no seu Mac enquanto o computador estiver conectado.
doseedo_desktop_statusO Dø Desktop está em execução e conectado ao Logic ? Quais sessões ele mantém? Se as edições serão publicadas — somente leitura.
doseedo_delete_sessionsExecute sessões de exclusão lógica em massa, começando com um teste a seco; nada no seu disco será alterado.

Projetos — importar, converter, construir

A metade em nível de arquivo: projetos inteiros de entrada e saída, em dez formatos de DAW.

FerramentaO que faz
doseedo_get_project_upload_urlUm upload pré-assinado para um arquivo zip do projeto (compacte a pasta para que o áudio seja enviado junto); multipartes acima de 4 GB.
doseedo_complete_project_uploadFinaliza o upload de um projeto multipartes a partir das ETags das partes.
doseedo_import_projectAbre um projeto Logic, Ableton, FL Studio, REAPER ou Pro Tools carregado como uma sessão editável — a porta de entrada para edit_session para um projeto que já existe.
doseedo_convert_projectConverte projetos entre Logic Pro, Ableton Live, FL Studio, Pro Tools, REAPER, Cubase, Dorico, Studio One e Bitwig, com GarageBand em 75 direções diferentes, reconstruído nativamente para que faixas, MIDI, áudio, tempo e marcadores sejam editáveis. auto2<target> Detecta a origem; uma opção remove plugins de terceiros para máquinas que não os possuem.
doseedo_audio_to_sessionMixagem completa de entrada, sessão nativa Logic ou Ableton de saída: stems separados em faixas nomeadas, mapa de tempo, marcadores de seção, MIDI opcional por stem e guia de acordes. Aproximadamente quatro minutos.

Áudio e música — gerar, separar, transcrever

As ferramentas de áudio com IA que estão por trás do site estão na mesma conexão.

FerramentaO que faz
doseedo_generate_musicUma música original ou instrumental a partir de um texto, com letra opcional e duração alvo. O andamento e a métrica são sugestões na legenda, não controles — uma parte que precisa se encaixar em uma sessão é escrita como notas e renderizada em vez de partitura.
doseedo_render_midiSuas notas exatas, tocadas por um instrumento modelado no seu andamento: notas em batidas, um arquivo MIDI ou uma faixa de sessão; até quatro takes por chamada, uma predefinição de timbre ou uma gravação curta cujo som será usado na renderização, e uma divisão de voz para acordes.
doseedo_cover_songRecriar uma música enviada, mantendo sua estrutura: trocar instrumentos por faixa, mudar o gênero, substituir a letra e, opcionalmente, usar o timbre de uma mixagem de referência.
doseedo_separate_stemsUma mixagem em vocais, bateria, baixo, guitarra, piano e outros instrumentos — ou um conjunto orquestral/detecção automática de instrumentos — com MIDI opcional por stem, uma divisão da bateria em bumbo, caixa, chimbal, tons e pratos, uma divisão da guitarra em músicos e uma sessão opcional criada a partir do resultado.
doseedo_transcribeÁudio para notas (altura, início, fim, velocidade, confiança) com dicas de instrumento, registro e polifonia — incluindo uma seção de metais por cadeiras — e, opcionalmente, o contorno contínuo da altura.

Análise — síncrona, sem créditos

Respostas em uma única chamada e sem custo; a grade na qual um agente escreve uma peça.

FerramentaO que faz
doseedo_analyze_songMapa de tonalidade, BPM e andamento por tempo, métrica, tempos fortes, seções e acordes de uma gravação.
doseedo_detect_chordsUm diagrama de acordes com durações em segundos e tempos.
doseedo_beat_gridTempos de batida e tempo forte, batidas por compasso, mapa de batidas.
doseedo_analyze_midiA harmonia das notas que você escreveu, antes de reproduzi-las ou colocá-las.

Arquivos, tarefas e a conta

A infraestrutura: uploads, espera, custo.

FerramentaO que faz
doseedo_get_upload_urlUm upload pré-assinado do seu próprio áudio (WAV, AIFF, FLAC, MP3, M4A, Ogg); retorna o audio_key Cada ferramenta de processamento leva.
doseedo_wait_taskAguarda a conclusão de uma tarefa assíncrona no servidor, por até 50 segundos por chamada, e retorna o resultado quando a tarefa for finalizada.
doseedo_check_taskUma verificação de status e novos links de download para um trabalho concluído cujos links expiraram.
doseedo_list_jobsOs trabalhos da conta, do mais recente para o mais antigo, filtrados por tipo, status ou sessão.
doseedo_cancel_jobInterrompe uma tarefa em fila ou em execução; o valor do reembolso depende do tipo de tarefa.
doseedo_quoteO custo de crédito de um trabalho antes de enviá-lo e se a conta pode arcar com ele agora. AbrirNão é necessário apresentar credencial.
doseedo_recipesOs pipelines nomeados — stems, session, cover, transcribe, generate, render-midi, analyze-song, convert, import-edit-export, bounce — com as entradas, as chamadas em ordem e como verificar. AbrirNão é necessário apresentar credencial.
doseedo_accountPlano, saldo de créditos mensais, uso extra adquirido, armazenamento — somente leitura.

Como é uma resposta?

Cada ferramenta responde em JSON, que é lido como prosa quando um agente o retransmite. Isso é real. doseedo_quote resposta, capturada em 15/10/2026, para uma gravação de 21 segundos de contrabaixo com três takes — observe que os três takes são gratuitos, que a regra está explicada em basise que affordable é respondido em relação à conta conectada:

{
  "job": "render_midi",
  "route": "/api/generate-stemphonic",
  "estimate": { "generation": 10 },
  "basis": "10 credits per 30 s window (21 s → 1 window) → 10 credits",
  "assumptions": [
    "takes (3) render in one GPU batch and cost nothing extra",
    "a chord part split into voices (voice_split) costs one batch per ~6 voices — pass voices to price it",
    "estimate only — the plane gate is authoritative and a refusal names the exact price",
    "failed jobs are refunded; free accounts also have a monthly ceiling"
  ],
  "account": { "tier": "…", "remaining": { "generation": "…" }, "resets_at": "2026-10-16T00:00:00+00:00" },
  "affordable": true
}

Os erros também têm uma forma — {error, code, retryable, plane, next, request_id} - e next é uma instrução que o agente segue: quando o serviço de análise não respondeu em 45 segundos durante a captura desta página, a resposta dizia "Aguarde 30 segundos e tente novamente APENAS UMA VEZ; não repita o processo.", a nova tentativa foi bem-sucedida, e o request_id É isso que o suporte solicita. Um resultado muito grande para uma única resposta retorna remodelado em vez de cortado: um truncated A lista indica quais arrays foram encurtados e next Explica como obter o restante.

Receitas: os dutos nomeados

doseedo_recipes Retorna dez pipelines que um agente acompanha chamada por chamada — stems, sessão (uma mixagem em um projeto DAW), cobrir, transcrever, gerar, render-midi (suas notas tocadas por um instrumento), analisar-música, converter, importar-editar-exportar (abrir um projeto, editá-lo, devolvê-lo) e quicar — cada um com suas entradas, as ferramentas em ordem, o custo e o tempo necessário, e como verificar o resultado a partir da resposta, em vez de descompactá-la. As mesmas receitas são enviadas como o pacote de habilidades (npx skills add doseedo/skills) para Claude Code, Cursor, Codex e os outros agentes que leem habilidades.

Conecte-o

Um único URL para todos os clientes. A instalação de cada um deles — Claude, ChatGPT, Cursor, Gemini CLI, Codex, VS Code — está a apenas uma página de distância.

O servidor Doseedo MCP →

Perguntas frequentes

Quantas ferramentas o servidor Doseedo MCP possui?

33, em cinco famílias: controle de sessão (ler, editar, baixar, exportar), projetos (importar, converter, criar a partir de áudio), áudio e música (gerar, renderizar MIDI, fazer cover, separar, transcrever), análise (tom, andamento, acordes, grade de batida, harmonia MIDI — síncrona e gratuita) e tarefas e conta (envios, aguardar, listar, cancelar, citar, receitas).

Quais ferramentas funcionam sem fazer login?

doseedo _recipes, doseedo _edit_ops_reference e doseedo _quote. Eles respondem a partir de constantes ou do catálogo público de operações e não consomem recursos. Todas as outras ferramentas exigem autenticação OAuth ou um cabeçalho X-API-Key.

Quais ferramentas são gratuitas?

As ferramentas de análise — analyze_song, detect_chords, beat_grid, analyze_midi — são executadas de forma síncrona e não consomem créditos, assim como leituras, orçamentos, listagens e as ferramentas de referência. Geração, renderização, covers, separação, transcrição, criação de sessões, conversões e bounces utilizam o saldo de créditos da conta; calcule os preços desses serviços primeiro.

Eu obtenho um arquivo MIDI do doseedo _transcribe`?

Retorna notas em formato JSON — altura, início e fim em segundos (e batidas quando um andamento é fornecido), velocidade e confiança. A separação com `include_midi` e `audio_to_session` grava MIDI no projeto; `render_midi` aceita um URL de arquivo MIDI padrão como entrada.

Onde está a lista de ferramentas legíveis por máquina?

Em doseedo — identidade, formato de autenticação e a tabela completa de ferramentas, construída a partir do mesmo array que o protocolo serve. Uma lista de ferramentas anônima no endpoint retorna o mesmo.

O servidor Doseedo MCP • Um único URL para cada cliente

Por DAW
Por cliente de IA
Por capacidade

Relacionado