Nerdearla Agenda MCP Server
Enables integration with n8n workflow automation platform for creating intelligent workflows that connect AI processing with external systems
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Nerdearla Agenda MCP Server what talks are happening next?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Nerdearla Agenda - MCP Server
Un servidor MCP (Model Context Protocol) que proporciona acceso a la agenda de Nerdearla en tiempo real, siguiendo la arquitectura MCP oficial.
🎪 Sobre Este Proyecto
Este MCP Server fue desarrollado como demostración práctica para la charla "Automatizá con flow: IA, n8n y MCP sin morir en el intento" presentada por Manuel Bruña y Carlos Pereyra en Nerdearla 2025.

La charla muestra cómo integrar:
🤖 Inteligencia Artificial
🔗 n8n para automatización de workflows
⚡ MCP (Model Context Protocol) para conectar IA con sistemas externos
¿Quieres ver la charla? 👉 Ver en Nerdearla
💡 Tip: Este proyecto es un ejemplo real de cómo implementar un MCP Server profesional que puede integrarse con Claude, n8n y otros sistemas de IA.
Related MCP server: Sessionize MCP Server
🏗️ Arquitectura MCP
Este proyecto implementa correctamente la arquitectura MCP con:
Data Layer: Protocolo JSON-RPC 2.0 para comunicación cliente-servidor
Transport Layer: Soporte para STDIO (local) y HTTP/SSE (remoto)
MCP Primitives: Tools para ejecutar funciones específicas de la agenda
🚀 Funcionalidades (MCP Tools)
Herramientas Disponibles
get_upcoming_talks - Obtiene las próximas charlas basadas en GMT-3. Incluye URLs cuando están disponibles.
get_past_talks - Obtiene charlas que ya pasaron. Incluye URLs cuando están disponibles.
get_topics_by_tags - Lista temas disponibles agrupados por tags
get_next_talk - Obtiene la próxima charla más cercana. Incluye URL cuando está disponible.
get_missed_talks - Obtiene charlas que empezaron pero podrías alcanzar. Incluye URLs cuando están disponibles.
get_best_talk_recommendation - Proporciona una recomendación experta sobre la charla más destacada del evento 🎯
get_cache_info - Información del sistema de cache inteligente (24 horas de duración)
🎪 Easter Egg
¿Buscas la mejor charla de Nerdearla? Prueba la herramienta get_best_talk_recommendation y descubre nuestra recomendación especial... 😉
⚡ Sistema de Cache Inteligente
El MCP Server implementa un sistema de cache avanzado para máximo rendimiento:
🚀 Inicialización Automática: Al arrancar el servidor, hace scraping completo automáticamente
⏰ Cache de 24 Horas: Los datos se mantienen válidos por 24 horas
⚡ Respuestas Instantáneas: Todas las consultas responden en <100ms después del cache inicial
🔄 Renovación Automática: Después de 24h, se actualiza automáticamente en la siguiente consulta
🛡️ Fallback Inteligente: Si falla el scraping, usa cache anterior disponible
# Al arrancar el servidor:
[agenda-service] 🚀 Initializing MCP Server - Starting initial cache...
[agenda-service] ✅ Initial cache ready! Scraped 45 talks in 8500ms
[agenda-service] ⚡ MCP Server ready - All queries will be INSTANT for 24 hours!
# En consultas posteriores:
[agenda-service] ⚡ Using cached data (15min old, 23h left) - INSTANT response!📦 Instalación
# Instalar pnpm si no lo tienes
npm install -g pnpm
# Instalar dependencias
pnpm install🎯 Uso
Transport STDIO (Claude Desktop)
# Servidor MCP para Claude Desktop
node src/index.js
# O con npm script
pnpm startTransport HTTP/SSE (Conexiones Remotas)
# Servidor MCP con HTTP transport
MCP_TRANSPORT=http node src/index.js
# Con puerto específico
MCP_TRANSPORT=http PORT=8000 node src/index.js
# O con npm script
pnpm start:http
# Con variables de entorno
MCP_TRANSPORT=http MCP_PORT=8000 pnpm start⚙️ Configuración Claude Desktop
Opción 1: STDIO Transport (Recomendado)
{
"mcpServers": {
"nerdearla-agenda-mcp": {
"command": "node",
"args": ["/ruta/absoluta/al/proyecto/src/index.js"]
}
}
}Opción 2: HTTP Transport (Remoto)
{
"mcpServers": {
"nerdearla-agenda-mcp": {
"command": "node",
"args": ["/ruta/absoluta/al/proyecto/src/index.js", "http", "3000"]
}
}
}Ubicación del archivo:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
🧪 Testing
Con MCP Inspector
# Inspector MCP (STDIO transport)
DANGEROUSLY_OMIT_AUTH=true npx @modelcontextprotocol/inspector node src/index.js
# Luego abrir: http://localhost:6274Testing Manual
# Test STDIO transport
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node src/index.js
# Test HTTP transport - Health check
curl http://localhost:3000/health
# Test HTTP transport - Server info
curl http://localhost:3000/
# Test MCP endpoint (Streamable HTTP)
curl http://localhost:3000/mcp🔍 MCP Inspector
Para probar con el MCP Inspector oficial:
# Opción 1: Script automático (Recomendado)
pnpm run inspector
# Opción 2: Manual
npx @modelcontextprotocol/inspector npx nerdearla-agenda
# Opción 3: Con servidor HTTP
# 1. Iniciar el servidor
pnpm start:http
# 2. En la interfaz del inspector:
# Transport Type: Streamable HTTP
# URL: http://localhost:3000/mcp🏗️ Arquitectura del Proyecto
src/
├── index.js # MCP Server principal con transport layers
├── agenda-service.js # Lógica de negocio (herramientas)
├── scraper.js # Web scraping con Puppeteer
├── time-utils.js # Utilidades de tiempo GMT-3
└── mcp-tools.js # Definición de MCP tools🔧 Características Técnicas
MCP Compliant: Sigue la arquitectura oficial MCP
Múltiples Transports: STDIO (local) y HTTP/SSE (remoto) con patrón profesional
Tool Discovery: Implementa
tools/listpara descubrimiento dinámicoTool Execution: Implementa
tools/callpara ejecución de herramientasHTTP Features: Health checks, CORS, autorización Bearer token opcional
Session Management: Manejo de sesiones SSE con cleanup automático
Scraping Inteligente: Puppeteer para contenido dinámico de React SPA
Cache Inteligente: Inicialización automática al arrancar + cache de 24 horas para respuestas instantáneas
Timezone GMT-3: Manejo correcto de hora argentina
Variables de Entorno: Configuración flexible con
MCP_TRANSPORT,MCP_PORT, etc.
📊 Ejemplo de Tool Execution
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_upcoming_talks",
"arguments": {
"limit": 3
}
}
}Respuesta:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\n \"currentTime\": \"2025-09-23T15:30:00-03:00\",\n \"upcomingTalks\": [...],\n \"total\": 3\n}"
}
]
}
}🚀 Build y Distribución
Node.js
# Crear paquete
pnpm build
# Instalar globalmente
pnpm install:global
# Usar globalmente
npx nerdearla-agenda-mcp
npx nerdearla-agenda-mcp http📦 Releases
Versión Actual: v1.2.0 - Sistema de Cache Inteligente
⚡ Cache automático al arrancar: Respuestas instantáneas desde el primer momento
🕒 Cache de 24 horas: Máximo rendimiento con renovación automática
🐳 Docker optimizado: Migración a pnpm y configuración mejorada
🛠️ Nueva herramienta:
get_cache_infopara monitoreo del sistema🔗 URLs incluidas: Enlaces a charlas cuando están disponibles
Ver CHANGELOG.md para historial completo de versiones.
🐳 Docker
# Ejecutar con Docker Compose (Recomendado)
docker-compose up --build
# Ejecutar en background
docker-compose up -d --build
# Solo Docker
docker build -t nerdearla-agenda-mcp .
docker run -p 3000:3000 nerdearla-agenda-mcp
# Con autenticación
docker run -p 3000:3000 \
-e MCP_BEARER=mi-token-secreto \
nerdearla-agenda-mcpVer DOCKER_GUIDE.md para configuración avanzada.
🆚 Transport Layers
Transport | Puerto | Uso | Conexión |
STDIO | - | Claude Desktop | Local |
HTTP/SSE | 3000 | Conexiones remotas | Red |
📚 Documentación MCP
👥 Autores
Speaker | GitHub | |
Manuel Bruña | ||
Carlos Pereyra |
🎯 Sobre la Charla
"Automatizá con flow: IA, n8n y MCP sin morir en el intento"
En esta charla demostramos cómo crear workflows inteligentes que conectan:
🤖 Claude/IA para procesamiento inteligente
🔗 n8n para orquestación de workflows
⚡ MCP para integración de sistemas externos
🌐 APIs REST para conectividad universal
🛠️ Stack Tecnológico Demostrado
MCP SDK 1.x - Protocolo de comunicación con IA
Node.js + TypeScript - Runtime y tipado
Puppeteer - Web scraping dinámico
Express - HTTP server
n8n - Automatización visual
Claude Desktop - Cliente MCP nativo
🌟 ¿Te Gustó el Proyecto?
Si este MCP Server te resultó útil:
⭐ Dale una estrella al repositorio
🐛 Reporta bugs si encuentras alguno
💡 Sugiere mejoras via Issues
🔄 Comparte con otros desarrolladores
📄 Licencia
MIT License - Siéntete libre de usar este código en tus propios proyectos.
Desarrollado con ❤️ para la comunidad de Nerdearla 2025
Available Tools
7 toolsget_best_talk_recommendationB
Proporciona una recomendación experta sobre cuál es la charla más destacada y valiosa del evento. Analiza contenido, speakers y relevancia para sugerir la experiencia más enriquecedora disponible.
Inputs: no named parameters.
get_cache_infoB
Obtiene información sobre el estado del cache de datos de la agenda. Muestra cuándo fue la última actualización, cuánto tiempo queda válido y estadísticas del cache.
Inputs: no named parameters.
get_missed_talksB
Obtiene las charlas que te perdiste (que empezaron pero no terminaron). Incluye URLs cuando están disponibles.
Inputs: no named parameters.
get_next_talkB
Obtiene la próxima charla más cercana. Incluye URL cuando está disponible.
Inputs: no named parameters.
get_past_talksB
Obtiene las charlas que ya pasaron. Incluye URLs cuando están disponibles.
Inputs: limit.
get_topics_by_tagsB
Lista los temas disponibles agrupados por tags
Inputs: no named parameters.
get_upcoming_talksB
Obtiene las próximas charlas basadas en la hora actual GMT-3. Incluye URLs cuando están disponibles.
Inputs: limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Every tool has a clearly distinct purpose with no overlap: get_best_talk_recommendation provides expert recommendations, get_cache_info handles cache status, get_missed_talks retrieves missed talks, get_next_talk gets the next upcoming talk, get_past_talks retrieves past talks, get_topics_by_tags lists topics by tags, and get_upcoming_talks lists upcoming talks. The descriptions clearly differentiate each tool's function, eliminating any ambiguity.
All tools follow a consistent verb_noun pattern using snake_case, starting with 'get_' or 'get_' followed by a descriptive noun phrase (e.g., get_best_talk_recommendation, get_upcoming_talks). This uniformity makes the tool set predictable and easy to understand, with no deviations in naming conventions.
With 7 tools, the server is well-scoped for an agenda management system, covering key operations like retrieving past, upcoming, missed, and next talks, along with recommendations, cache info, and topic listings. Each tool earns its place without being excessive or insufficient for the domain.
The tool set provides comprehensive coverage for querying and retrieving agenda data, including temporal views (past, upcoming, next, missed), recommendations, cache status, and topics. A minor gap exists in the lack of update or management tools (e.g., adding or modifying talks), but for a read-only agenda server, the surface is largely complete and supports common agent workflows without dead ends.
Maintenance
Related MCP Connectors
Manage Eventtia events, attendees, registrations, agendas and check-ins from any AI assistant.
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Public VITUR data for events, tickets, speakers, companies, agendas and sector news.
Read your events, sales, orders and attendees from your AI assistant. OAuth sign-in, read only.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides information about Nerdearla events, speakers, and sessions, enabling natural language queries about event data.10Creative Commons Zero v1.0 Universal
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to search for speakers and talks by date using the Sessionize API.-
- AlicenseNot gradedqualityDmaintenanceExposes the conference schedule as tools for ChatGPT, allowing attendees to view talks and buy tickets through natural language.1MIT
- FlicenseNot gradedqualityCmaintenanceEnables users to query a conference agenda through MCP, listing sessions and finding when specific talks occur via natural-language agent requests.-