Case de Sucesso: Como o meucasamento.ai usa o MCP da Feriados API para planejar casamentos

Planejar um casamento envolve dezenas de variáveis, mas uma das primeiras e mais importantes é a escolha da data e local. Muitos casais, no entanto, esquecem de checar um detalhe crucial: feriados.

Imagine agendar seu casamento dos sonhos apenas para descobrir posteriormente que a data cai em um feriado municipal ou estadual prolongado. O resultado? Fornecedores cobrando taxas extras, trânsito complicado na cidade e hotéis exigindo pacotes de 3 diárias mínimas dos convidados que vêm de fora.

Foi para resolver exatamente esse problema de forma inteligente e preditiva que no meucasamento.ai integramos o novo MCP da Feriados API.

Neste artigo, detalhamos como a adoção do Model Context Protocol (MCP) da Feriados API permitiu empoderar nossos agentes de IA (baseados no Google Agent Development Kit – ADK) a atuarem não apenas como chatbots, mas como verdadeiros concierges consultivos de casamento via WhatsApp — tudo isso com zero configuração extra de código.

O Desafio: Contexto Hiperlocal no Planejamento

O meucasamento.ai opera através de uma assistente virtual chamada Sofia. Ela utiliza fluxos guiados para conduzir o planejamento do casal através do WhatsApp, organizando desde o orçamento inicial (Budget) e estimativa de convidados (PAX) até a definição de estilo e data.

No backend da Sofia, orquestramos múltiplos especialistas baseados em IA utilizando o ambiente do Google ADK (Agent Development Kit). Nossa dor técnica era como dar à IA a capacidade de identificar rapidamente feriados em 5.570 municípios brasileiros e 27 estados, além dos feriados nacionais, sem ter que codificar rotinas de chamadas de API, gerenciar cache, mapear respostas complexas para injeção no prompt ou lidar com as limitações inerentes de Context Window da LLM.

A Feriados API já nos entregava dados extremamente confiáveis, mas a adoção do recém-lançado mcp.feriadosapi.com elevou a capacidade do nosso sistema a outro patamar arquitetural.

Como funciona a integração: Zero Código, Muito Contexto

O Model Context Protocol (MCP) funciona como um plug-and-play para Agentes de IA. Ao invés de criarmos ferramentas customizadas (custom tools) na mão dentro do nosso código, o servidor MCP descreve suas próprias ferramentas e as expõe diretamente para a nossa Engine baseada em ADK.

Passo 1: Configuração do Cliente no ADK

Para fornecer à Sofia toda a base de dados de feriados do Brasil, abandonamos a ideia de escrever wrappers customizados de API. Como o ADK é um framework "code-first", habilitamos a leitura do MCP instanciando a classe McpToolset com a URL remota, diretamente na definição do nosso Agente Especialista:

import { Agent } from '@google/adk';
import { gemini25Flash } from '@google/adk/models';
import { McpToolset, SseConnectionParams } from '@google/adk/tools';

// 1. Configurando a conexão remota via Server-Sent Events (SSE)
const mcpParams = new SseConnectionParams(
    "https://mcp.feriadosapi.com/api/mcp",
    { headers: { "Authorization": "Bearer SUA_API_KEY" } }
);

// 2. Conectando o Toolset para descobrir automaticamente as ferramentas
const feriadosToolset = await McpToolset.create(mcpParams);

// 3. Adicionando as ferramentas ao construir o nosso agente no ADK
const sofiaAgenteDePlanejamento = new Agent({
    name: 'SofiaPlanner',
    model: gemini25Flash,
    instructions: 'Você é a Sofia, uma especialista em casamentos...',
    tools: [
        feriadosToolset, // <-- Todas as ferramentas MCP injetadas!
        consultarOrcamento, 
        definirDataEStilo
    ]
});

Instantaneamente, a IA passou a compreender e ter acesso a 7 novas tools robustas expostas pelo servidor MCP: buscar_feriados, feriados_nacionais, feriados_por_estado, feriados_por_cidade, verificar_data, listar_estados e buscar_municipios.

Passo 2: Contexto Seguro com Google ADK

Seguindo nossas diretrizes de arquitetura limpa e o padrão ADK Secure Context Management, também criamos uma tool intermediadora (facade) que injeta o código IBGE automaticamente sem depender do LLM adivinhar ou pedir essa informação sensível aos noivos:

import { ToolContext } from '@google/adk';

// Nossa tool intercepta a lógica e repassa para a tool nativa do MCP
async function checarFeriadosCasamento(
    date: string,
    tool_context: ToolContext
) {
    // 1. O ToolContext recupera o ID do casal injetado internamente 
    // previnindo ataques de IDOR e resolvendo a cidade (IBGE)
    const casal = await db.getCouple(tool_context.session.coupleId);
    
    // 2. Invocamos a lógica MCP com parâmetros hiperlocais validados
    return await agent.callTool("verificar_data", {
         date: date,
         ibge: casal.cityIbge
    });
}

O Valor na Prática: Uma IA mais humana e consultiva

Veja um exemplo real de como a Sofia passou a se comportar com um de nossos clientes através do WhatsApp, guiada pelo conhecimento exposto via MCP:

Conclusão: Menos código, mais inteligência

Do ponto de vista de arquitetura de software, construir inteligência artificial corporativa exige abstração e redução de débito técnico. Com o MCP da Feriados API, nós não precisamos mais reescrever código de integração ou dar manutenção em wrappers de APIs REST. O servidor expõe as capacidades de busca de feriados com perfeição para o LLM.

Se o seu sistema atua nos setores de eventos, logística, e-commerce ou planejamento financeiro, o uso do MCP da Feriados API é altamente recomendado. Você resolve a complexidade insana da tabela dinâmica de feriados móveis e estáticos do Brasil utilizando um parágrafo de configuração e colhendo benefícios em minutos de experimentação.

Acesse nosso projeto em meucasamento.ai para ver como a IA está transformando o planejamento matrimonial no Brasil.