Case Study: How meucasamento.ai Uses Brazilian Holidays MCP for Event Planning

Planning a destination wedding in Brazil involves orchestrating dozens of complex variables, but one of the most critical decisions happens on day one: selecting the date and venue city. Yet, couples and event planners frequently overlook a hidden pitfall: hyperlocal and municipal holidays.

Imagine booking your dream wedding at a scenic beach resort or historic chapel, only to discover weeks later that your date coincides with a major local patron saint festival or municipal holiday weekend. The consequences? Vendors charging overtime premiums, gridlocked traffic, and hotels enforcing mandatory 3-night minimum stays for out-of-town guests.

In this architecture case study, we examine how next-generation AI assistants like Sofia—an autonomous wedding planning concierge built with Google's Agent Development Kit (ADK)—leverage the Model Context Protocol (MCP) and Feriados API to proactively protect couples from calendar disasters across all 5,570 Brazilian municipalities.

The Destination Wedding Dilemma in Brazil

Brazil is a prime destination for weddings, from the vineyards of Bento Gonçalves to the beaches of Trancoso and Ilhabela. However, each of these municipalities has its own municipal holidays, founding anniversaries, and religious observances that do not appear on standard national calendars.

When building conversational AI agents for event planning, standard LLMs lack access to these granular regional calendars. Without live data injection, an AI concierge might endorse a date that causes severe budget overruns or logistical nightmares for the couple and their guests.

Architecting an Intelligent Planner with Google ADK and MCP

To solve this, developers use the Model Context Protocol (MCP) to connect autonomous agents directly to the Feriados API real-time calendar engine. When Sofia proposes or evaluates a wedding date, she executes MCP tool calls natively to verify whether the date or surrounding weekend is impacted by local holidays.

1. Injecting MCP Tools into Google ADK

Using the Google Agent Development Kit (ADK), connecting remote MCP servers over Server-Sent Events (SSE) or HTTP takes only a few lines of TypeScript:

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

// 1. Configure remote connection via Server-Sent Events (SSE)
const mcpParams = new SseConnectionParams(
    "https://mcp.feriadosapi.com/api/mcp",
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);

// 2. Initialize Toolset to automatically discover Feriados tools
const feriadosToolset = await McpToolset.create(mcpParams);

// 3. Inject tools into your autonomous agent in ADK
const sofiaPlannerAgent = new Agent({
    name: 'SofiaPlanner',
    model: gemini25Flash,
    instructions: 'You are Sofia, an AI wedding planner specializing in destination weddings in Brazil...',
    tools: [
        feriadosToolset, // <-- All MCP tools natively injected!
        queryBudget, 
        setDateAndVenue
    ]
});

2. Secure Context & IBGE Resolution

In enterprise agent architectures, passing user IDs or city codes directly in prompt strings can introduce security vulnerabilities or hallucinations. Using ADK's ToolContext, Sofia resolves the venue's official 7-digit IBGE code internally from the authenticated session before querying the holiday database:

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

// Custom wrapper intercepting date verification in our session context
async function checkWeddingDateHolidays(
    date: string,
    tool_context: ToolContext
) {
    // 1. ToolContext retrieves the session coupleId securely,
    // preventing IDOR attacks and resolving the venue city (IBGE)
    const couple = await db.getCouple(tool_context.session.coupleId);
    
    // 2. Execute MCP verification with validated hyperlocal parameters
    return await agent.callTool("verificar_data", {
         date: date,
         ibge: couple.venueCityIbge
    });
}

Proactive Intelligence in Action

When equipped with Feriados MCP, Sofia does not just answer questions—she acts as a proactive advisor. For example, if a couple asks to schedule a wedding in Ilhabela on September 3, 2026, Sofia queries the municipal calendar, detects the local Emancipation Day holiday, and warns the couple about hotel minimum-stay requirements and ferry congestion before they sign any contracts.

By combining agentic reasoning with hyperlocal Brazilian calendar data, travel and event platforms can deliver unprecedented value, trust, and precision to their users.

Are you building AI concierges or scheduling agents for the Brazilian market? Get your free Feriados API key today and integrate our MCP server in minutes.