AgileHero

npx add-mcp 'https://mcp.agilehero.io/mcp'

AgileHero inclui um servidor MCP integrado: adicione uma URL a qualquer assistente de IA compatível com MCP, faça login com sua conta AgileHero, e ele trabalha em seus projetos exatamente com suas permissões — 49 ferramentas em boards, backlog, épicos, wiki, whiteboards, retrospectivas e roadmap. Esta referência é gerada a partir do próprio servidor, então está sempre atualizada.

Novo por aqui? Comece com a visão geral de agentes de IA, ou vá direto para conectar seu cliente abaixo. Texto rico em todo este servidor é AgileHero Markup (AHM) — um dialeto XML estrito e validado, projetado para que agentes nunca corrompam conteúdo humano. Escrevendo um script em vez de conectar um assistente? A referência da API REST usa o mesmo login OAuth.

Conecte seu cliente de IA

Conectar significa duas coisas: adicione a URL do endpoint ao seu cliente e, em seguida, faça login com sua conta AgileHero quando o cliente solicitar. Não há chave para criar ou colar. Uma vez conectado, o cliente age como você, com exatamente suas permissões; cada cliente conectado está listado em Configurações → Clientes de IA no aplicativo, onde você pode revogá-lo a qualquer momento. Observadores não podem usar o servidor MCP: um workspace onde você é observador não é listado, e tudo nele é lido como não encontrado.

Endpoint

https://mcp.agilehero.io/mcp

Transporte

Streamable HTTP (POST)

Login

Seu cliente de IA abre uma janela do navegador; aprove uma vez, revogue a qualquer momento em Configurações → Clientes de IA.

Claude Code

Execute uma vez no terminal; o Claude Code armazena o servidor na sua configuração de nível de usuário e faz login pelo seu navegador.

claude mcp add --transport http --scope user agilehero https://mcp.agilehero.io/mcp

• Todas as flags devem vir antes do nome do servidor.
• Em seguida, execute /mcp dentro de uma sessão do Claude Code e escolha Autenticar (ou execute claude mcp login agilehero) e aprove o login no seu navegador.

Verificar: Execute claude mcp list — agilehero deve aparecer como conectado. Se mostrar "requer autenticação", execute claude mcp login agilehero.

Documentação do Claude Code · verificado na documentação do fornecedor em 2026-09-15

VS Code (GitHub Copilot)

Adicione a .vscode/mcp.json em um workspace, ou execute "MCP: Abrir Configuração do Usuário" para todos os workspaces. Uma janela do navegador abre para o login na primeira vez que o servidor inicia.

.vscode/mcp.json

{
  "servers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• "type": "http" é obrigatório — sem ele, o VS Code trata a URL como um comando a ser executado.

Verificar: Execute "MCP: Listar Servidores", inicie agilehero, conclua o login no navegador e verifique se as ferramentas aparecem na visualização de Chat.

Documentação do VS Code (GitHub Copilot) · verificado na documentação do fornecedor em 2026-09-15

Codex

Adicione pelo terminal e, em seguida, faça login — a configuração é compartilhada pelo Codex CLI, pela extensão do IDE e pelo aplicativo de desktop do ChatGPT.

codex mcp add agilehero --url https://mcp.agilehero.io/mcp
codex mcp login agilehero

• O Codex não inicia o login sozinho — execute codex mcp login agilehero após adicionar o servidor.

Verificar: Execute codex mcp list — agilehero deve aparecer como autenticado; em seguida, peça ao Codex para listar seus projetos AgileHero.

Documentação do Codex · verificado na documentação do fornecedor em 2026-09-15

Zed

Adicione a settings.json, ou use Configurações → IA → Servidores MCP → Adicionar Servidor Remoto; o Zed solicita que você faça login.

~/.config/zed/settings.json

{
  "context_servers": {
    "agilehero": {
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• Deixe os headers de fora — o Zed inicia o login apenas quando nenhum header Authorization está configurado.

Verificar: Reinicie o Zed, aprove o login no navegador quando solicitado e peça para listar seus projetos AgileHero — a primeira chamada bem-sucedida confirma a conexão.

Documentação do Zed · verificado na documentação do fornecedor em 2026-09-15

GitHub Copilot CLI

Adicione a ~/.copilot/mcp-config.json, ou .mcp.json dentro de um repositório.

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• Requer GitHub Copilot CLI 1.0.83 ou mais recente (suporte a Client ID Metadata Document).
• O Copilot CLI abre o login quando o servidor solicita pela primeira vez; você também pode executar /mcp auth agilehero dentro de uma sessão.

Verificar: Execute /mcp dentro do Copilot CLI — agilehero deve estar listado como conectado com suas ferramentas.

Documentação do GitHub Copilot CLI · verificado na documentação do fornecedor em 2026-09-15

Claude (web, desktop, Cowork)

Adicione AgileHero como um conector personalizado e faça login; o conector está disponível no Claude na web, Claude Desktop, Cowork e nos aplicativos móveis.

Settings → Connectors → Add custom connector
Name: AgileHero
URL: https://mcp.agilehero.io/mcp
Sign in now

• O conector também aparece no Claude Code quando ele está conectado com a mesma conta Claude.
• Plano gratuito: um conector personalizado. Team e Enterprise: um Owner adiciona o conector, e cada membro faz login com sua própria conta AgileHero.

Verificar: Inicie um novo chat — AgileHero está listado em conectores, e pedir ao Claude para listar seus projetos AgileHero funciona.

Documentação do Claude (web, desktop, Cowork) · verificado na documentação do fornecedor em 2026-09-15

ChatGPT

Crie um conector no modo Desenvolvedor e faça login com OAuth.

Settings → Connectors → Create (Developer mode)
Name: AgileHero
MCP server URL: https://mcp.agilehero.io/mcp
Authentication: OAuth

• Disponível em Plus, Pro, Business, Enterprise e Edu com o modo Desenvolvedor ativado; em um workspace, um admin ou owner publica o conector para os membros.

Verificar: Abra um novo chat com o conector AgileHero ativado e peça ao ChatGPT para listar seus projetos AgileHero.

Documentação do ChatGPT · verificado na documentação do fornecedor em 2026-09-15

Outro cliente

Qualquer cliente MCP que suporte OAuth com Client ID Metadata Documents: adicione o endpoint como um servidor remoto (Streamable HTTP) e aprove o login no seu navegador.

Transport: Streamable HTTP
URL: https://mcp.agilehero.io/mcp
Authentication: OAuth (sign in when the client asks)

• Clientes que suportam apenas tokens estáticos ou headers não podem se conectar — AgileHero usa apenas login OAuth.

Verificar: Reinicie o cliente, aprove o login no navegador quando solicitado e peça para listar seus projetos AgileHero — a primeira chamada bem-sucedida confirma a conexão.

Documentação de outros clientes · verificado na documentação do fornecedor em 2026-09-15

Ainda não suportado

Estes clientes ainda não podem fazer login no AgileHero. A maioria deles não tem suporte para Client ID Metadata Documents, o método de registro de cliente OAuth que o AgileHero usa (a recomendação atual do MCP); verificamos regularmente a documentação do fornecedor e movemos um cliente para cima assim que ele se qualifica.

CursorAinda não

O Cursor ainda não suporta Client ID Metadata Documents (seu login OAuth precisa de Dynamic Client Registration ou um cliente pré-registrado), então não pode se conectar ao AgileHero por enquanto.

Documentação do Cursor · verificado na documentação do fornecedor em 2026-09-15

OpenCodeAinda não

O OpenCode ainda não suporta Client ID Metadata Documents (seu login OAuth precisa de Dynamic Client Registration ou um cliente pré-registrado), então não pode se conectar ao AgileHero por enquanto.

Documentação do OpenCode · verificado na documentação do fornecedor em 2026-09-15

Gemini CLIAinda não

O Gemini CLI ainda não suporta Client ID Metadata Documents (seu login OAuth precisa de Dynamic Client Registration ou um cliente pré-registrado), então não pode se conectar ao AgileHero por enquanto.

Documentação do Gemini CLI · verificado na documentação do fornecedor em 2026-09-15

ClineAinda não

O Cline ainda não suporta Client ID Metadata Documents (seu login OAuth precisa de Dynamic Client Registration ou um cliente pré-registrado), então não pode se conectar ao AgileHero por enquanto.

Documentação do Cline · verificado na documentação do fornecedor em 2026-09-15

Google AntigravityAinda não

O Google Antigravity ainda não suporta Client ID Metadata Documents (seu login OAuth precisa de Dynamic Client Registration ou um cliente pré-registrado), então não pode se conectar ao AgileHero por enquanto.

Documentação do Google Antigravity · verificado na documentação do fornecedor em 2026-09-15

AmpAinda não

O Amp ainda não suporta Client ID Metadata Documents (seu login OAuth precisa de Dynamic Client Registration ou um cliente pré-registrado), então não pode se conectar ao AgileHero por enquanto.

Documentação do Amp · verificado na documentação do fornecedor em 2026-09-15

Raycast AIAinda não

O Raycast AI ainda não suporta Client ID Metadata Documents (seu login OAuth precisa de Dynamic Client Registration ou um cliente pré-registrado), então não pode se conectar ao AgileHero por enquanto.

Documentação do Raycast AI · verificado na documentação do fornecedor em 2026-09-15

KiroAinda não

O Kiro faz login com uma URL de Client ID Metadata Document que você fornece, e o AgileHero ainda não hospeda um Client ID Metadata Document para ele.

Documentação do Kiro · verificado na documentação do fornecedor em 2026-09-15

WarpAinda não

O Warp não tem login OAuth para servidores adicionados pelo usuário ainda, então não pode se conectar ao AgileHero por enquanto.

Documentação do Warp · verificado na documentação do fornecedor em 2026-09-15

JetBrains AI AssistantAinda não

O JetBrains AI Assistant não tem login OAuth para servidores remotos, e a ponte mcp-remote precisaria de um documento de cliente hospedado — o AgileHero ainda não hospeda um Client ID Metadata Document para ele.

Documentação do JetBrains AI Assistant · verificado na documentação do fornecedor em 2026-09-15

ContinueAinda não

O Continue não tem login OAuth para servidores Streamable HTTP, e a ponte mcp-remote precisaria de um documento de cliente hospedado — o AgileHero ainda não hospeda um Client ID Metadata Document para ele.

Documentação do Continue · verificado na documentação do fornecedor em 2026-09-15

Instruções do servidor

Cada cliente MCP recebe estas convenções no momento da inicialização:

Servidor MCP AgileHero.

Cada parâmetro id e cada id em uma resposta é um uid curto — sempre use uids retornados pelas ferramentas list/get/search, nunca invente um. A maioria das ferramentas precisa de um uid de projeto — chame list_projects primeiro para descobrir workspaces e projetos. Prefira search (texto completo, todos os tipos de conteúdo) em vez de search_cards (substring de título, um projeto).

Em ferramentas de atualização, prefira os campos delta add_*/remove_* para coleções (incremental, seguro); os campos de coleção simples (assigned_to, labels, checklists, cards_relations, links, attachments) SUBSTITUEM o estado anterior e não podem ser combinados com seus deltas. Itens de checklist são { description, checked }. Acompanhe as mudanças com updated_since em list_cards / list_epics.

Use move_card (não update_card) para alterar a lista ou posição de um card; um list_id vazio significa o backlog.

As ferramentas de wiki, whiteboard, retrospectiva e roadmap exigem que o workspace do projeto esteja em um plano Pro ou trial. As gravações de elementos do whiteboard são ferramentas em lote e tudo-ou-nada; os uids de elementos vêm de get_whiteboard. Itens de retrospectiva são gerenciados com add_retro_items e move_retro_item (move_card recusa cards de retrospectiva).

Limites diários: chamadas de ferramentas são medidas por usuário por workspace — 500/dia no plano Gratuito, 5.000/dia no Pro ou trial, reiniciando às 00:00 UTC. get_ahm_spec e list_projects nunca são contadas (nem qualquer chamada não atribuível a um único workspace, como uma busca sem escopo). Acima do limite, as ferramentas retornam um erro de limite diário até a reinicialização ou upgrade.

TODO texto rico (páginas de wiki, descrições de cards/épicos, comentários) é AgileHero Markup (AHM) — XML estrito, NUNCA markdown ou HTML; chame get_ahm_spec uma vez antes de escrever qualquer um. Edições de texto rico são em duas etapas por design: preview_wiki_page_update / preview_description_update (consequências + preview_token), depois a ferramenta de atualização correspondente com esse token.

Documentação completa das ferramentas: https://agilehero.io/docs/mcp

Especificação AHM: https://agilehero.io/docs/mcp/agilehero-markup

Ferramentas (49)

list_projectsSomente leitura

Lista todos os workspaces e projetos que o usuário do token pode acessar, para que o agente possa resolver o uid do projeto que a maioria das outras ferramentas exige. Chame isso primeiro sempre que nenhum uid de projeto for conhecido — nunca peça ao usuário para colar um. Retorna workspaces (uid, nome, plano, seu papel) com seus projetos (uid, nome, url). Ferramentas do pilar Pro (wiki, métricas) precisam que o plano do workspace seja pro ou trial.

searchSomente leitura

A pesquisa global de texto completo do produto (OpenSearch): cards, épicos, páginas wiki e projetos, correspondendo a títulos, descrições, comentários, itens de checklist e nomes de anexos, classificados por relevância com um reforço de recência. Use isso para encontrar qualquer coisa por conteúdo ("o card onde discutimos a migração"); use search_cards apenas para buscas de substring no título dentro de um projeto. Cada resultado carrega um tipo, um uid pronto para ação (cards alimentam get_card/update_card, épicos alimentam get_epic, wiki_pages alimentam show_wiki_page, projetos alimentam os parâmetros project_id), uma url de deep-link e trechos destacados por <mark> mostrando por que houve correspondência. Opcionalmente, escopo com project_id ou assigned_to_me. Pagine com page/per_page; total_count é a contagem total de correspondências.

Parâmetro	Tipo	Obrigatório	Descrição
query	string	sim	Consulta de busca em texto livre
project_id	string		Uid opcional do projeto para limitar a busca
assigned_to_me	boolean		Apenas resultados atribuídos ao usuário do token
page	integer		Número da página (padrão 1)
per_page	integer		Resultados por página, 1-50 (padrão 20)

get_cardsomente leitura

Lê um card por completo: sua descrição em AgileHero Markup com ids de bloco mais description_version (as duas entradas que preview_description_update / update_description recebem), posição na lista, épico, etiquetas, responsáveis, reportador, tipo, estimativa, data de vencimento, checklists, links, anexos, cards relacionados e comentários em tópicos. Recebe apenas o uid do card — não há parâmetro project_id. Os uids dos cards vêm de list_cards, search ou search_cards.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	O identificador único do card

get_epicsomente leitura

Lê um épico por completo: sua descrição em AgileHero Markup com ids de bloco mais description_version (as duas entradas que preview_description_update / update_description recebem), nome, número, cor, datas de início/fim, responsáveis, checklists, links, anexos, cada card nele (uid, número, título e sua lista com categoria — lista nula = backlog — em ordem do quadro, então esta é a forma de listar todos os cards de um épico e ver quais estão a fazer, em andamento ou concluídos) e comentários em tópicos. Recebe apenas o uid do épico — não há parâmetro project_id. Os uids dos épicos vêm de list_epics ou search.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	O identificador único do épico

list_wiki_pathsPro · wikisomente leitura

Lista toda a árvore wiki de um projeto em ordem de exibição — cada pasta e página com seu uid, nome, tipo (página ou pasta) e parent_id — para que o agente possa resolver o uid da página que show_wiki_page recebe e escolher um parent_id para create_wiki_page. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único do projeto

show_wiki_pagePro · wikisomente leitura

Recupera uma página wiki como AgileHero Markup (AHM) com seu document_version. O conteúdo é AHM, não markdown — ids de bloco, âncoras <discussion> e referências <image/>/<attachment/> fazem parte do documento; leia get_ahm_spec antes de editar. Edite via preview_wiki_page_update e depois update_wiki_page, usando os ids de bloco e document_version retornados aqui. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	O identificador único do caminho da página

get_ahm_specsomente leitura

A especificação do AgileHero Markup (AHM) v1.0 — o ÚNICO formato de texto rico que o AgileHero aceita (markdown e HTML são rejeitados). Leia isso UMA VEZ antes de escrever ou editar qualquer texto rico (páginas wiki, descrições de cards/épicos, comentários): vocabulário, atributos, regras de escape e um exemplo prático. Mesmo texto na web: https://agilehero.io/docs/mcp/agilehero-markup

create_wiki_pagePro · wiki

Cria uma página wiki (opcionalmente dentro de uma pasta) com conteúdo em AgileHero Markup (AHM). O conteúdo deve ser envolvido em <agile-hero-markup version="1.0"> — markdown e HTML são rejeitados; leia get_ahm_spec primeiro. Retorna o uid da nova página, url, document_version e conteúdo. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único (uid) do projeto
name	string	sim	Título da página
parent_id	string		Uid opcional da pasta (de list_wiki_paths)
content	string		Corpo da página como AHM; omita para uma página vazia

preview_wiki_page_updatePro · wikisomente leitura

PRIMEIRO passo OBRIGATÓRIO de toda atualização de página wiki: valida as operações e retorna as consequências calculadas pelo servidor (blocos adicionados/removidos/alterados, arquivos que seriam excluídos permanentemente, discussões de equipe que perderiam suas âncoras, avisos de possível markdown) além do preview_token que update_wiki_page exige. Nada é modificado. As operações são endereçadas por bloco (replace_block / insert_after / delete_block / move_block) com conteúdo AHM — leia get_ahm_spec primeiro e obtenha ids de bloco + document_version de show_wiki_page. Revise as consequências antes de salvar: uma exclusão de arquivo listada ou desancoragem de discussão só é aceitável quando o usuário a solicitou. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	Uid do caminho da página
document_version	string	sim	De show_wiki_page — comprova atualidade
operations	array de objeto	sim	Aplicadas em ordem contra o documento em evolução

update_wiki_pagePro · wikidestrutivo

Aplica uma atualização previamente visualizada a uma página wiki. Exige o preview_token de preview_wiki_page_update para EXATAMENTE estas operações e este document_version — salvar sem visualizar é impossível por design. Cada salvamento cria uma versão de página que humanos podem reverter no aplicativo. Retorna a página atualizada (AHM + novo document_version) e as consequências aplicadas. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	Uid do caminho da página
document_version	string	sim	A versão contra a qual a visualização foi feita
operations	array de objeto	sim	As operações exatas que foram visualizadas
preview_token	string	sim	De preview_wiki_page_update

preview_description_updatesomente leitura

PRIMEIRO passo OBRIGATÓRIO de toda edição de descrição de card ou épico: valida as operações de bloco e retorna as consequências calculadas pelo servidor além do preview_token que update_description exige. Nada é modificado. O conteúdo é AgileHero Markup (AHM, superfície de descrição: sem tabelas, cores, alinhamento, discussões ou anexos de arquivo) — leia get_ahm_spec primeiro; ids de bloco e document_version vêm de get_card / get_epic.

Parâmetro	Tipo	Obrigatório	Descrição
resource_type	enum: card | epic	sim
id	string	sim	Uid do card ou épico
document_version	string	sim	De get_card / get_epic
operations	array de objeto	sim	Aplicadas em ordem contra a descrição em evolução

update_descriptiondestrutivo

Aplica uma atualização de descrição previamente visualizada a um card ou épico. Exige o preview_token de preview_description_update para EXATAMENTE estas operações e este document_version — salvar sem visualizar é impossível por design. Retorna a descrição atualizada (AHM + novo document_version).

Parâmetro	Tipo	Obrigatório	Descrição
resource_type	enum: card | epic	sim
id	string	sim	Uid do card ou épico
document_version	string	sim	A versão contra a qual a visualização foi feita
operations	array de objeto	sim	As operações exatas que foram visualizadas
preview_token	string	sim	De preview_description_update

list_whiteboardsPro · whiteboardsomente leitura

Lista os whiteboards de um projeto (uid, nome, contagem de elementos, url). Use get_whiteboard para ler os elementos de um quadro. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único do projeto

create_whiteboardPro · whiteboard

Cria um whiteboard vazio em um projeto. Adicione conteúdo com create_whiteboard_elements. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único do projeto
name	string	sim	Nome do whiteboard

get_whiteboardPro · whiteboardsomente leitura

Lê um whiteboard como uma representação de texto compacta: limites do quadro mais uma linha por elemento — "<type> <uid> em <x>,<y> tamanho <w>x<h> [cor] [pai <frame-uid>] [vinculado <card|epic> <uid>] \"texto\"", conectores como "conector <uid> <from> -> <to>". Os uids de elementos daqui são os identificadores que toda ferramenta de escrita de whiteboard recebe. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	O identificador único do whiteboard

create_whiteboard_elementsPro · whiteboard

Cria até 100 elementos de whiteboard em uma única chamada transacional (tudo ou nada, um evento em tempo real). Tamanhos nativos, cores e posicionamento de texto são aplicados no lado do servidor — geralmente basta fornecer tipo + texto (+ cor). Omita x/y e os elementos são organizados automaticamente (grade por padrão; arrange: row|column|grid, origin_x/origin_y/gap para ajustar); forneça x/y para controle total. Frames contêm elementos via parent_id (um uid de frame existente) ou parent_ref (a ref de um frame anterior NESTA chamada). Conectores vinculam elementos por uid (source_id/target_id) ou ref de lote (source_ref/target_ref) — nunca por coordenadas; âncoras são calculadas pela interface. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
whiteboard_id	string	sim	O identificador único do whiteboard
elements	array de objeto	sim	Criados em ordem de array — refs só resolvem para trás
arrange	enum: grid | row | column		Layout para elementos sem x/y explícito (padrão grid)
origin_x	number		Início x da organização automática (padrão 100)
origin_y	number		Início y da organização automática (padrão 100)
gap	number		Espaçamento da organização automática em px (padrão 20)

create_whiteboard_diagramPro · whiteboard

Desenha um diagrama (fluxograma, processo, grafo de dependências) em um whiteboard a partir de um grafo semântico — nós, arestas, grupos opcionais, SEM coordenadas: o servidor faz o layout em camadas de cima para baixo com tamanhos nativos e retorna os uids dos elementos criados, chaveados pelos seus ids de nó. Posicionado abaixo do conteúdo existente do quadro. Transacional (tudo ou nada, um evento em tempo real). Máximo de 20 nós — divida fluxos maiores em dois diagramas. Mantenha formas simples (retângulo) a menos que a semântica exija uma (losango = decisão, estádio = início/fim, cilindro = armazenamento de dados). Edite o resultado com update_whiteboard_elements — o layout nunca é executado novamente. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
whiteboard_id	string	sim	O identificador único do whiteboard
title	string		Título do diagrama (título do frame, ou um cabeçalho quando grupos são usados)
nodes	array de objeto	sim
edges	array de objeto
groups	array de objeto
origin_x	number		Opcional, x do canto superior esquerdo; padrão abaixo do conteúdo existente
origin_y	number		Opcional, y do canto superior esquerdo; padrão abaixo do conteúdo existente

update_whiteboard_elementsPro · whiteboard

Atualize até 100 elementos de quadro branco em uma única chamada tudo-ou-nada: mover (x/y), redimensionar, reordenar (z_index), alterar texto, recolorir, reparentar (parent_id — um uid de frame, ou "" para desanexar) e setas/caminhos/rótulos de conectores. Os uids dos elementos vêm de get_whiteboard; os tipos de elementos não podem ser alterados. Apenas os campos fornecidos mudam — propriedades não relacionadas são preservadas. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
whiteboard_id	string	sim	O identificador único do quadro branco
updates	array de objeto	sim

delete_whiteboard_elementsPro · whiteboarddestrutivo

Exclua até 100 elementos de quadro branco em uma única chamada transacional. Excluir um frame ou nó de mapa mental libera seus filhos no quadro (eles NÃO são excluídos — inclua seus uids explicitamente para excluí-los também). Conectores anexados a elementos excluídos não são removidos e ficarão pendentes. Os uids dos elementos vêm de get_whiteboard. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
whiteboard_id	string	sim	O identificador único do quadro branco
ids	array de string	sim	Uids dos elementos a excluir

review_whiteboardPro · whiteboardsomente leitura

Execute verificações de qualidade determinísticas em um quadro branco: texto provavelmente transbordando seu elemento, elementos visivelmente sobrepostos, conectores com extremidades não vinculadas ou pendentes, cores fora da paleta da interface, posições fora da grade e elementos cujo pai foi excluído. Aviso — as descobertas são sugestões, não erros, e um quadro com descobertas pode ser exatamente o que o usuário deseja. Use após desenhar para verificação de sanidade, corrija no máximo uma vez e não fique em loop perseguindo um relatório vazio. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	O identificador único do quadro branco

convert_whiteboard_elementPro · whiteboard

Converta um elemento de quadro branco em um item de backlog: um post-it em um cartão ou uma épica, ou um frame em uma épica (os filhos post-it do frame tornam-se cartões nessa épica; filhos já convertidos são reatribuídos, não duplicados). O elemento permanece no quadro, vinculado ao que se tornou — get_whiteboard mostra o vínculo. Um elemento só pode ser convertido uma vez. O texto do post-it/frame torna-se o título, a menos que você forneça um. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	Uid do elemento (um sticky_note ou frame, de get_whiteboard)
to	enum: card | epic	sim	O que criar
title	string		Título do cartão / nome da épica; padrão é o texto do elemento
list_id	string		Somente cartão: uid da lista de destino; omita para o backlog
color	string		Somente épica: cor hexadecimal; padrão é a cor do elemento

convert_mind_mapPro · whiteboard

Converta um mapa mental em itens de backlog com um mapeamento por nó: a raiz pode se tornar uma nova épica (papel "epic") ou anexar a uma existente (papel "existing_epic" + target_epic_id); outros nós tornam-se cartões nessa épica (papel "card") ou rótulos de projeto (papel "label" — nós de rótulo acima de um nó de cartão na árvore são aplicados a esse cartão); papel "skip" ignora um nó. Passe o uid do elemento RAIZ como id e cada nó que você deseja converter em nodes (nós não listados são ignorados). Uma conversão por nó: nós já convertidos são rejeitados antecipadamente — reenvie sem eles. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	O uid do nó raiz do mapa mental (de get_whiteboard)
nodes	array de objeto	sim
target_epic_id	string		Uid da épica, obrigatório com papel "existing_epic" na raiz

list_retrospectivesPro · retrospectivassomente leitura

Liste as retrospectivas de um projeto: retrospectivas de novo modelo e health checks onde o workspace as possui, quadros de retrospectiva clássicos caso contrário. Uma entrada de novo modelo tem uid, name, kind (retro | health_check), status (open | live | closed), date (starts_on; closes_on para um health check), estágio atual, template, uid do facilitador, contagens das ações que criou e url; a resposta adiciona o open_actions_count do projeto. Use get_retrospective para o quadro completo. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único do projeto

create_retrospectivePro · retrospectivas

Crie uma retrospectiva: uma retrospectiva de novo modelo onde o workspace as possui, um quadro de retrospectiva clássico caso contrário; a resposta é a retrospectiva como get_retrospective a retorna (colunas com seus uids), para que add_retro_items possa seguir imediatamente. Uma retrospectiva de novo modelo vem de um template (padrão went_well), está aberta para notas imediatamente e tem você como facilitador; opcional: focus, anonimato (padrão: o do template), participant_ids (uma retro de membros selecionados; omita para todos os membros do projeto com acesso de escrita), os tipos de pergunta check_in e feedback, e votos. O facilitador a inicia e executa seus estágios no aplicativo. Quadros clássicos aceitam apenas name, date e previous_retrospective_id e recusam os argumentos de novo modelo. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único do projeto
name	string	sim	Nome da retrospectiva
template	enum: went_well | start_stop_continue | four_ls | mad_sad_glad | kalm | daki | starfish | plus_delta | sailboat | rose_thorn_bud | wrap | hot_air_balloon | three_pigs | project_retro | postmortem | kudos_lessons		Chave do template; padrão went_well
starts_on	string		Data, ISO-8601 (YYYY-MM-DD); padrão é hoje
starts_at	string		Alias obsoleto de starts_on
focus	string		Sobre o que é esta retro, mostrado sob seu nome
anonymity	enum: anonymous | optional | named		Quem é mostrado nas notas: anonymous, optional (autores podem adicionar seu nome) ou named
participant_ids	array de string		Uids de usuário dos participantes (list_project_users); você é sempre um deles
check_in	enum: safety | mood | esvp | one_word		Pergunta de check-in (padrão safety)
feedback	enum: roti | pulse | one_word		Pergunta de feedback de encerramento (padrão roti)
votes	objeto		Configurações de votos: budget (auto | fixed | unlimited), per_person (1-20), max_per_topic (1-10)
previous_retrospective_id	string		Somente quadros clássicos: uid de uma retrospectiva anterior cuja coluna de Ações mostra como "Ações passadas"

get_retrospectivePro · retrospectivassomente leitura

Leia uma retrospectiva como você pode vê-la: uma retrospectiva de novo modelo ou health check onde o workspace os possui, um quadro de retrospectiva clássico caso contrário. Uma retrospectiva de novo modelo retorna configuração, estágios (atual, timer, progresso), colunas (com uids) contendo tópicos (grupos de notas, com uids), totais de check-in e feedback, seus votos restantes, a fila de Discuss e tópicos estacionados, propostas, ações (as que criou mais as abertas do projeto) e, uma vez fechada, seu resumo. A privacidade segue a sala: antes da revelação, você obtém apenas suas próprias notas (cada coluna conta as de todos), autores apenas em notas nomeadas, totais de votos apenas quando os votos são revelados. Um health check retorna suas dimensões e participação, suas próprias avaliações enquanto aberto e agregados por dimensão uma vez fechado. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	O uid da retrospectiva (de list_retrospectives)

add_retro_itemsPro · retrospectivas

Adicione itens a uma retrospectiva como você mesmo, vários de uma vez: notas em uma retrospectiva de novo modelo onde o workspace as possui, cartões em um quadro de retrospectiva clássico caso contrário. Cada item é { column, text, recipient_id? }: column é um título de coluna (sem diferenciar maiúsculas/minúsculas) ou uid de get_retrospective; text tem até 1000 caracteres (255 em quadros clássicos); recipient_id, o uid do usuário do colega agradecido, é obrigatório em uma coluna de kudos de novo modelo e recusado em quadros clássicos. Uma nota de novo modelo inicia seu próprio tópico e outros a veem quando as notas são reveladas; notas são tomadas apenas enquanto a retrospectiva está aberta para notas ou no estágio Write, caso contrário a chamada é recusada com código wrong_stage e o estágio atual. Falha PARCIAL: itens válidos são adicionados, inválidos são relatados por índice — verifique o array "failed". Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
retrospective_id	string	sim	O uid da retrospectiva
items	array de objeto	sim

move_retro_itemPro · retrospectivas

Mova um item de retrospectiva: reagrupe uma nota em uma retrospectiva de novo modelo onde o workspace as possui, mova um cartão para outra coluna de um quadro de retrospectiva clássico caso contrário. Novo modelo, apenas estágio Group: topic_id coloca a nota nesse tópico (grupo de notas); column (título ou uid) a torna um tópico próprio ali, na posição entre os tópicos da coluna (omita para o último). Passe expected_updated_at, o updated_at do tópico da nota de get_retrospective, para ser recusado com código stale quando alguém o reagrupou enquanto isso. Fora do Group, a chamada é recusada com código wrong_stage e o estágio atual; kudos e outras notas nunca se misturam. Quadros clássicos aceitam apenas column e position (position omitida = topo). Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	O uid da nota (quadros clássicos: o uid do item) de get_retrospective
topic_id	string		Uid do tópico de destino; deixe column de fora
column	string		Título ou uid da coluna de destino
position	inteiro		Índice na coluna de destino (0 = primeiro)
expected_updated_at	string		O updated_at do tópico da nota como lido por último (verificação de conflito)

list_project_userssomente leitura

Liste os membros de um projeto — todos os membros do workspace para um projeto padrão; o criador, os proprietários e administradores do workspace, e qualquer pessoa adicionada explicitamente para um privado — para que o agente possa resolver uids de responsáveis em vez de adivinhar nomes. Retorna o uid de cada membro, nome completo, email e papel no workspace (owner, admin, member ou observer). Esses uids são o que assigned_to aceita em create_card, update_card, create_epic, update_epic e create_roadmap_slot.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único do projeto

list_board_lists somente leitura

Liste as listas do quadro kanban de um projeto para que o agente possa resolver um destino move_card válido. Retorna cada lista ativa em ordem de exibição com seu uid (utilizável como destino move_card) e nome de exibição. O backlog é incluído como uma entrada selecionável com um id de string vazia.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único (uid) do projeto

list_epicssomente leitura

Liste as épicas de um projeto para que o agente possa resolver uids de épicas para get_epic e atribuição de cartões. Retorna cada épica em ordem de exibição (posição crescente) com seu uid, número, nome, descrição (Markdown), cor, datas de início/fim e contagens de cartões.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único (uid) do projeto
updated_since	string		Apenas épicas cujo registro mudou nesta data ou depois desta data ISO-8601 ou datetime. Ressalva: edições de coleção (checklists, links) podem não alterar o tempo de mudança de uma épica; edições de nome/data/descrição sempre alteram.

list_labelssomente leitura

Liste os rótulos de um projeto para que o agente possa reutilizar a taxonomia existente em vez de criar quase-duplicatas em gravações de cartões. Retorna cada rótulo em ordem de exibição (posição crescente) com seu uid, nome e posição.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único (uid) do projeto

list_cardsSomente leitura

Lista os cartões de uma lista kanban, ou do backlog do projeto quando list_id é omitido ou vazio, na ordem de exibição do quadro (topo da coluna primeiro, ou seja, posição de colocação decrescente — a mesma ordem que a interface do produto mostra). Os filtros combinam com AND: epic_id, label_id, assigned_user_id e reporter_id usam uids (um uid desconhecido não corresponde a nada); due_date mantém cartões com vencimento na data fornecida ou antes dela. Retorna resumos de cartões suficientes para ações (uid, título, lista + posição, épico, etiquetas, responsáveis, reportador, data de vencimento) prontos para get_card / move_card / update_card, paginados com limit (padrão 50, máximo 100) e offset; total_count é a contagem filtrada completa.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único (uid) do projeto
list_id	string		Uid da lista para ler; omita ou passe uma string vazia para o backlog
epic_id	string		Apenas cartões neste épico (uid do épico) dentro da lista ou backlog escolhido; para listar todos os cartões de um épico em todas as listas, use get_epic
label_id	string		Apenas cartões com esta etiqueta (uid da etiqueta)
assigned_user_id	string		Apenas cartões atribuídos a este usuário (uid do usuário)
reporter_id	string		Apenas cartões reportados (criados) por este usuário (uid do usuário)
due_date	string		Apenas cartões com vencimento na data fornecida ou antes dela (ISO-8601, ex.: 2026-06-10)
updated_since	string		Apenas cartões cujo registro mudou nesta data ou datetime ISO-8601 ou depois — o filtro "o que mudou desde a última execução". Atenção: edições em coleções anexadas (etiquetas, checklists, links) podem não atualizar o tempo de mudança de um cartão; edições de título/descrição/escalares sempre atualizam.
limit	integer		Tamanho da página, 1-100 (padrão 50)
offset	integer		Número de cartões para pular (padrão 0)

search_cardsSomente leitura

Pesquisa de cartões por substring no título dentro de um projeto (quadro kanban e backlog), correspondendo exatamente à pesquisa de cartões ao vivo no produto (substring insensível a maiúsculas/minúsculas no banco de dados apenas no título do cartão — descrições e comentários não são pesquisados; use a ferramenta de busca para pesquisa de texto completo em todos os tipos de conteúdo), ordenada do mais recente criado primeiro. Retorna resumos de cartões suficientes para ações (uid, título, posição de lista + posição, épico, etiquetas, responsáveis, reportador, data de vencimento); uma consulta sem correspondências retorna um array de cartões vazio, não um erro. Pagine com limit (padrão 50, máximo 100) e offset; total_count é a contagem completa de correspondências.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único (uid) do projeto
query	string	sim	Texto para corresponder aos títulos dos cartões (substring insensível a maiúsculas/minúsculas)
limit	integer		Tamanho da página, 1-100 (padrão 50)
offset	integer		Número de cartões correspondentes para pular (padrão 0)

list_attention_cardsPro · métricassomente leitura

Lista os cartões que precisam de atenção no quadro kanban de um projeto — as mesmas listas das páginas de Métricas do produto. Tipos: stuck (parado em uma coluna, não backlog/Concluído, sem movimento por mais de 7 dias; mais tempo parado primeiro), blocking (cartões não concluídos que estão bloqueando outros cartões), overdue (vencimento nos próximos 7 dias ou já vencidos; mais próximos primeiro). kind seleciona uma lista ou 'all' (padrão). Opcionalmente, filtre por um uid de responsável ou o literal 'unassigned'. Cada seção solicitada retorna resumos de cartões prontos para get_card / move_card / update_card, limitados a limit com o total_count completo. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único (uid) do projeto
kind	enum: stuck | blocking | overdue | all		Qual lista de atenção retornar (padrão 'all' = cada lista como sua própria seção)
assignee_id	string		Apenas cartões atribuídos a este uid de usuário, ou 'unassigned' para cartões sem responsável
limit	integer		Máximo de cartões por seção, 1-100 (padrão 50)

get_metrics_summaryPro · métricassomente leitura

Contagens em uma única chamada dos cartões que precisam de atenção no quadro kanban de um projeto: overdue_cards_count, blocking_cards_count e stuck_cards_count — as mesmas definições de list_attention_cards, que retorna os cartões por trás de cada contagem. Barato; chame isso primeiro para decidir se uma análise mais profunda vale a pena. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único (uid) do projeto

list_roadmap_slotsPro · roadmapSomente leitura

Lista os slots do roadmap de um projeto que se sobrepõem a uma janela de datas (padrão: este mês até cinco meses à frente). Um slot agenda um épico entre duas datas e pode ter responsáveis; um épico pode ter vários slots, incluindo sobreposições — isso é por design. Retorna no máximo 200 slots — estreite a janela se for limitado. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único do projeto
start_date	string		Início da janela, ISO-8601 (YYYY-MM-DD); padrão: início deste mês
end_date	string		Fim da janela, ISO-8601; padrão: start_date + 6 meses

create_roadmap_slotPro · roadmap

Agenda um épico no roadmap do projeto: um slot de start_date a end_date, opcionalmente com responsáveis. Um épico pode ter vários slots e sobreposições são permitidas por design — verifique list_roadmap_slots primeiro se você pretende estender um slot existente em vez de adicionar um. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	O identificador único do projeto
epic_id	string	sim	Uid do épico (de list_epics); deve pertencer a este projeto
start_date	string	sim	ISO-8601 (YYYY-MM-DD)
end_date	string	sim	ISO-8601; o mesmo dia que start_date é permitido
assigned_to	array de string		Uids de usuários para atribuir (membros do projeto — veja list_project_users)

update_roadmap_slotPro · roadmap

Atualiza um slot do roadmap: reagende ou redimensione (start_date/end_date), mova para outro épico do mesmo projeto (epic_id) ou defina seus responsáveis. Apenas os campos fornecidos mudam, EXCETO assigned_to que SUBSTITUI o conjunto completo de responsáveis — leia o slot primeiro e envie todos que devem permanecer. Uids de slots vêm de list_roadmap_slots. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	O uid do slot do roadmap
epic_id	string		Novo uid do épico (mesmo projeto)
start_date	string		ISO-8601 (YYYY-MM-DD)
end_date	string		ISO-8601
assigned_to	array de string		SUBSTITUI todos os responsáveis (uids de usuários, membros do projeto); [] limpa

delete_roadmap_slotPro · roadmappermaneente

Exclui PERMANENTEMENTE um slot do roadmap (e seus links de responsáveis). Isso não pode ser desfeito — não há lixeira para slots do roadmap. O épico em si não é tocado; para reagendar, prefira update_roadmap_slot. Requer um workspace Pro ou de teste.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	O uid do slot do roadmap (de list_roadmap_slots)

create_label

Cria uma nova etiqueta em um projeto por nome. Se uma etiqueta com o mesmo nome já existir (insensível a maiúsculas/minúsculas), a etiqueta existente é retornada inalterada em vez de criar uma quase duplicada. A nova etiqueta é anexada ao final da ordem de exibição.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	Uid do projeto ao qual a etiqueta pertence
name	string	sim

create_card

Cria um cartão no quadro kanban de um projeto. Apenas project_id e title são obrigatórios. Omita list_id para colocar o cartão no backlog; omita position para entrar no final da fila (move_card documenta o contrato de posição). description é AgileHero Markup — nunca markdown ou HTML; leia get_ahm_spec primeiro. epic_id e uids de responsáveis devem já existir (list_epics, list_project_users), enquanto nomes de etiquetas que ainda não existem são criados no projeto. estimation é complexidade Fibonacci (0/1/2/3/5/8/13), não uma estimativa de tempo. Checklists, links, anexos e relações de cartões podem ser fornecidos nesta mesma chamada.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	Uid do projeto ao qual o cartão pertence (o cartão é criado no quadro kanban do projeto)
list_id	string		Uid da lista; omita para colocar no backlog
position	integer
type	enum: story | bug | chore | research
title	string	sim
description	string		AgileHero Markup (AHM) — nunca markdown ou HTML; leia get_ahm_spec primeiro. Superfície de descrição: sem tabelas, cores, alinhamento ou discussões.
epic_id	string		Uid do épico; deve já existir no projeto
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Estimativa de complexidade em pontos de história (escala Fibonacci), não uma estimativa de tempo
due_date	string		Data ISO-8601
assigned_to	array de string		Uids de usuários responsáveis, descobríveis via list_project_users
labels	array de string		Nomes de etiquetas; nomes desconhecidos são criados no projeto
checklists	array de objeto		Cada { name, items: [{ description, checked }] }; itens mantêm a ordem fornecida
cards_relations	array de objeto		Cada { type, target_card_id (um uid de cartão no mesmo quadro) }
links	array de objeto		Cada { url, description }
attachments	array de objeto		Cada { url, name }; o arquivo é buscado da url

update_cardpermanente

Atualiza um cartão existente pelo seu uid. Para coleções, prefira os campos delta add_*/remove_* (edições incrementais seguras: add_labels, remove_assignees, add_checklist_items, check_items, …); os campos de coleção simples (labels, assigned_to, checklists, cards_relations, links, attachments) SUBSTITUEM o estado anterior de forma destrutiva e não podem ser combinados com seus deltas. Use move_card para mudar lista ou posição, e preview_description_update / update_description para editar a descrição.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	UID do cartão
type	enum: story | bug | chore | research
title	string
epic_id	string
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Estimativa de complexidade em story points (escala de Fibonacci), não é uma estimativa de tempo
due_date	string		Data ISO-8601
assigned_to	array of string		UIDs dos usuários responsáveis, descobertos via list_project_users; substitui os responsáveis do cartão
labels	array of string		Nomes dos rótulos; nomes desconhecidos são criados no projeto; substitui os rótulos do cartão
checklists	array of object		Cada { name, items: [{ description, checked }] }; os itens mantêm a ordem fornecida; substitui os checklists do cartão
cards_relations	array of object		Cada { type, target_card_id (um UID de cartão no mesmo quadro) }; substitui as relações do cartão
links	array of object		Cada { url, description }; substitui os links do cartão
attachments	array of object		Cada { url, name }; o arquivo é buscado a partir da url; substitui os anexos do cartão
add_labels	array of string		Adiciona rótulos por nome (nomes desconhecidos são criados); mantém os rótulos existentes
remove_labels	array of string		Remove rótulos por nome (sem diferenciar maiúsculas de minúsculas); nomes ausentes não têm efeito
add_assignees	array of string		Adiciona responsáveis por UID de usuário; mantém os responsáveis existentes
remove_assignees	array of string		Remove responsáveis por UID de usuário; UIDs ausentes não têm efeito
add_checklist_items	array of object		Adiciona itens: cada { checklist, description, checked? } — o checklist nomeado é criado se não existir
check_items	array of object		Marca itens como concluídos, correspondidos por descrição exata dentro do checklist nomeado
uncheck_items	array of object		Marca itens como não concluídos (mesma correspondência de check_items)
remove_checklist_items	array of object		Exclui itens; itens ausentes não têm efeito
add_relations	array of object		Adiciona relações; mantém as relações existentes
remove_relations	array of object		Remove relações correspondentes; ausentes não têm efeito
add_links	array of object		Adiciona links: cada { url, description? }; mantém os links existentes
remove_links	array of string		Remove links por url exata; urls ausentes não têm efeito

delete_carddestrutivo

Exclui suavemente um cartão pelo seu UID: ele sai do quadro e de todas as listagens, suas relações com outros cartões são removidas, qualquer sessão de estimativa nele é desativada e elementos de quadro branco vinculados a ele são desvinculados. O épico ao qual pertencia não é excluído. Não há desfazer exclusão via MCP.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	UID do cartão

move_card

Move um cartão para uma lista diferente (ou altera sua posição dentro da mesma lista). Somente cartões em um quadro kanban podem ser movidos; cartões em quadros retrospectivos são rejeitados. Passe uma string vazia para list_id para mover o cartão para o backlog do kanban. Uma lista é exibida de cima para baixo a partir de sua posição mais alta, então a posição 0 é a PARTE INFERIOR da lista. Omita a posição para entrar no final da fila (a parte inferior, posição 0) no backlog e nas listas to_do e in_progress, ou no topo de uma lista done.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	UID do cartão
list_id	string	sim	UID da lista de destino; string vazia move para o backlog (somente kanban)
position	integer		Posicionamento dentro do destino: 0 é a parte inferior e a posição mais alta é o topo. Deve estar entre 0 e o número de outros cartões já no destino. Omita para entrar no final da fila (posição 0) no backlog e nas listas to_do e in_progress, ou no topo de uma lista done.

create_epic

Cria um épico em um projeto. Somente project_id e name são obrigatórios. description é AgileHero Markup — nunca markdown ou HTML; leia get_ahm_spec primeiro. UIDs de responsáveis vêm de list_project_users. Checklists, links e anexos podem ser fornecidos nesta mesma chamada. Retorna o novo UID do épico — o que create_card / update_card aceitam como epic_id, e o que create_roadmap_slot agenda.

Parâmetro	Tipo	Obrigatório	Descrição
project_id	string	sim	UID do projeto ao qual o épico pertence
name	string	sim
description	string		AgileHero Markup (AHM) — nunca markdown ou HTML; leia get_ahm_spec primeiro. Superfície de descrição: sem tabelas, cores, alinhamento ou discussões.
color	string		Cor hexadecimal como #0060F0
start_date	string		Data ISO-8601
end_date	string		Data ISO-8601
assigned_to	array of string		UIDs dos usuários responsáveis, descobertos via list_project_users
checklists	array of object		Cada { name, items: [{ description, checked }] }; os itens mantêm a ordem fornecida
links	array of object		Cada { url, description }
attachments	array of object		Cada { url, name }; o arquivo é buscado a partir da url

update_epicdestrutivo

Atualiza um épico existente pelo seu UID; somente os campos fornecidos são alterados. Para coleções, prefira os campos delta add_*/remove_* (edições incrementais seguras); os campos de coleção simples (assigned_to, checklists, links, attachments) SUBSTITUEM o estado anterior de forma destrutiva e não podem ser combinados com seus deltas. Use preview_description_update / update_description para editar a descrição.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	UID do épico
name	string
color	string		Cor hexadecimal como #0060F0
start_date	string		Data ISO-8601
end_date	string		Data ISO-8601
assigned_to	array of string		UIDs dos usuários responsáveis, descobertos via list_project_users; substitui os responsáveis do épico
checklists	array of object		Cada { name, items: [{ description, checked }] }; substitui os checklists do épico
links	array of object		Cada { url, description }; substitui os links do épico
attachments	array of object		Cada { url, name }; o arquivo é buscado a partir da url; substitui os anexos do épico
add_assignees	array of string		Adiciona responsáveis por UID de usuário; mantém os responsáveis existentes
remove_assignees	array of string		Remove responsáveis por UID de usuário; UIDs ausentes não têm efeito
add_checklist_items	array of object		Adiciona itens: cada { checklist, description, checked? } — o checklist nomeado é criado se não existir
check_items	array of object		Marca itens como concluídos, correspondidos por descrição exata dentro do checklist nomeado
uncheck_items	array of object		Marca itens como não concluídos (mesma correspondência de check_items)
remove_checklist_items	array of object		Exclui itens; itens ausentes não têm efeito
add_links	array of object		Adiciona links: cada { url, description? }; mantém os links existentes
remove_links	array of string		Remove links por url exata; urls ausentes não têm efeito

delete_epicdestrutivo

Exclui suavemente um épico pelo seu UID. Seus cartões NÃO são excluídos — eles permanecem no quadro, desvinculados do épico. Os slots de roadmap do épico SÃO excluídos permanentemente (um slot agenda um épico, então não faz sentido sem um), e elementos de quadro branco vinculados ao épico são desvinculados.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	UID do épico

create_comment

Adiciona um comentário a um cartão ou a um épico. Forneça exatamente um de card_id ou epic_id. O conteúdo é AgileHero Markup (AHM, superfície de comentário: sem tabelas, mídia, cores, alinhamento ou discussões) — nunca markdown ou HTML; leia get_ahm_spec primeiro. O comentário é atribuído ao usuário conectado em nome do qual este cliente atua e aparece nas respostas subsequentes de get_card / get_epic. Comentários não podem ser editados via MCP; delete_comment remove os seus próprios (corrija erros com delete + repost). Passe parent_comment_id para responder a um comentário existente. Threads têm um nível de profundidade: responder a uma resposta anexa o novo comentário à raiz do thread dessa resposta, então não tente aninhar respostas. O pai deve ser um comentário no mesmo cartão ou épico — um UID de qualquer outro lugar é rejeitado.

Parâmetro	Tipo	Obrigatório	Descrição
card_id	string		UID do cartão para comentar (mutuamente exclusivo com epic_id)
epic_id	string		UID do épico para comentar (mutuamente exclusivo com card_id)
content	string	sim	Corpo do comentário como AgileHero Markup (AHM)
parent_comment_id	string		UID opcional de um comentário no MESMO cartão ou épico para responder. Omita para um comentário de nível superior. Responder a uma resposta normaliza para a raiz do thread dessa resposta (threads têm um nível de profundidade).

delete_commentdestrutivo

Exclui um comentário que VOCÊ postou (comentários são atribuídos ao usuário conectado em nome do qual este cliente atua — comentários de outras pessoas não podem ser excluídos). O padrão de correção é delete + postar um comentário corrigido com create_comment. Um comentário excluído que tem respostas permanece visível como um marcador em seu thread. UIDs de comentários vêm de get_card / get_epic.

Parâmetro	Tipo	Obrigatório	Descrição
id	string	sim	UID do comentário