Cria e salva um novo arquivo de configuração (Catálogo Central Global ~/.firebird-mcp.json por padrão). Permite associar o banco a projetos específicos (ex: projects=['web_projects']) e tags.

Lista todos os bancos de dados Firebird configurados no Catálogo Central Global (~/.firebird-mcp.json) ou arquivo local, identificando os bancos correspondentes ao projeto ativo. Informa se há necessidade de confirmação/pergunta ao usuário quando houver múltiplos bancos no projeto.

Define o banco de dados ativo da sessão entre os configurados no catálogo. Suporta busca inteligente por nome exato, case-insensitive, substring no alias ou tag (ex: 'auditoria' -> 'erp_auditoria'). Todas as chamadas seguintes que não especificarem 'db_alias' utilizarão este banco ativo.

Cadastra ou atualiza um banco de dados dinamicamente no catálogo (global ou local). Permite associar o banco a projetos específicos (projects=['web_projects']) e tags para filtragem contextual.

Recarrega a configuração de bancos a partir do Catálogo Central Global (~/.firebird-mcp.json) ou arquivo local do projeto.

Lista todas as tabelas de usuário (não de sistema) do banco especificado (ou ativo na sessão). Se houver múltiplos bancos no projeto e nenhum estiver ativo na sessão, pergunte antes ao usuário.

Lista todas as views de usuário do banco especificado (ou ativo na sessão). Se houver múltiplos bancos no projeto e nenhum estiver ativo na sessão, pergunte antes ao usuário.

Lista todas as Stored Procedures cadastradas no banco especificado (ou ativo na sessão). Se houver múltiplos bancos no projeto e nenhum estiver ativo na sessão, pergunte antes ao usuário.

Lista todos os Generators / Sequences de usuário no banco especificado (ou ativo na sessão). Se houver múltiplos bancos no projeto e nenhum estiver ativo na sessão, pergunte antes ao usuário.

Inspeciona detalhadamente a estrutura de uma tabela no Firebird:

• Colunas, tipos exatos (DECFLOAT, INT128, BOOLEAN, VARCHAR, BLOB SUB_TYPE), domínios e nullability

• Chaves primárias (PK) e estrangeiras (FK)

• Índices com ordem (ASC/DESC), colunas participantes e taxa de seletividade real (RDB$STATISTICS). Se houver múltiplos bancos no projeto e nenhum estiver ativo na sessão, pergunte antes ao usuário.

Compila uma consulta SQL no Firebird e extrai o plano de execução compilado (PLAN). Analisa leituras sequenciais (NATURAL SCAN) em tabelas, ordenações em memória (SORT) e fornece recomendações cirúrgicas de indexação e reescrita. Se houver múltiplos bancos no projeto e nenhum estiver ativo na sessão, pergunte antes ao usuário.

Executa consulta SELECT de leitura no Firebird com limite seguro de linhas (1 a 1000). Seguro: Rejeita comandos de alteração de dados e encerra a transação com commit imediato. Se houver múltiplos bancos no projeto e nenhum estiver ativo na sessão, pergunte antes ao usuário.

Executa comandos de manipulação de dados (INSERT, UPDATE, DELETE, EXECUTE PROCEDURE).

REGRA RÍGIDA DE SEGURANÇA — DUPLA CONFIRMAÇÃO OBRIGATÓRIA: O assistente NUNCA deve executar comandos DML sem autorização expressa do usuário. Etapas obrigatórias antes da execução:

1. Apresentar o SQL exato que será executado.

2. Explicar claramente o que o comando faz.

3. Detalhar o impacto no banco (tabelas e registros afetados, reversibilidade, riscos de lock ou perda de dados).

4. Solicitar a confirmação direta do usuário para prosseguir.

SOMENTE após o usuário responder confirmando expressamente no chat, reexecute passando confirmed=True. Se houver múltiplos bancos no projeto e nenhum estiver ativo na sessão, pergunte antes ao usuário.

Executa comandos estruturais DDL no Firebird (CREATE, ALTER, DROP, RECREATE, etc.) com commit explícito.

REGRA RÍGIDA DE SEGURANÇA — DUPLA CONFIRMAÇÃO OBRIGATÓRIA: O assistente NUNCA deve executar comandos estruturais sem autorização expressa do usuário. Etapas obrigatórias antes da execução:

1. Apresentar a instrução DDL exata que será executada.

2. Explicar claramente o que ela altera na estrutura do banco.

3. Detalhar o impacto técnico (bloqueios exclusivos de metadados, dependências, irreversibilidade de DROP).

4. Solicitar a confirmação direta do usuário para prosseguir.

SOMENTE após o usuário responder confirmando expressamente no chat, reexecute passando confirmed=True. Se houver múltiplos bancos no projeto e nenhum estiver ativo na sessão, pergunte antes ao usuário.

Diagnostica a integridade e telemetria do banco Firebird através das tabelas MON$:

• Versão do Engine e ODS

• Tamanho de página (Page Size) e sweep interval

• Diagnóstico do gap OAT (Oldest Active Transaction) vs Next Transaction para prevenção de inchaço do .fdb

• Total de conexões ativas, transações e statements abertos. Se houver múltiplos bancos no projeto e nenhum estiver ativo na sessão, pergunte antes ao usuário.