> ## Documentation Index
> Fetch the complete documentation index at: https://docs.migraflow.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramentas MCP

> Parâmetros, retornos e momento adequado para cada ferramenta MigraFlow.

## `validate_schema`

Valida DDL, detecta o dialeto e apresenta uma prévia das tabelas.

| Parâmetro | Tipo   | Obrigatório |
| --------- | ------ | ----------- |
| `ddl`     | string | sim         |

Use antes da análise completa para detectar problemas de entrada.

## `analyze_schema`

Retorna relatório legível com resumo, mapping, Risk Score, findings, SQL e gaps de evidência.

| Parâmetro        | Tipo   | Padrão       |
| ---------------- | ------ | ------------ |
| `ddl`            | string | obrigatório  |
| `context`        | string | vazio        |
| `target_dialect` | string | `postgresql` |

## `analyze_assessment`

Retorna apenas o manifesto estruturado AS-IS/TO-BE em JSON. Prefira esta ferramenta quando outro sistema ou agente precisar interpretar estados sem extrair dados de Markdown.

## `review_migration`

Revisa um script proposto e apresenta score de qualidade, problemas, correções, índices e constraints ausentes.

| Parâmetro        | Tipo   | Padrão       |
| ---------------- | ------ | ------------ |
| `migration_sql`  | string | obrigatório  |
| `target_dialect` | string | `postgresql` |
| `context`        | string | vazio        |

## `explain_mapping`

Consulta decisões, riscos, otimizações e alternativas de um mapping persistido.

| Parâmetro    | Tipo    | Obrigatório |
| ------------ | ------- | ----------- |
| `mapping_id` | inteiro | sim         |

O identificador deve vir de uma execução persistida válida; não invente IDs.

## `parse_nosql`

Interpreta JSON Schema, schema Mongoose ou documentos de amostra e devolve collections, campos e relações detectadas.

## `get_docs_url`

Não recebe parâmetros. Use para confirmar que o servidor foi registrado e obter uma referência rápida.

<Warning>
  As ferramentas geram observações e recomendações. Nenhuma delas registra aprovação do cliente, autoriza exclusões ou executa SQL em produção.
</Warning>