Paulo

Posted on Mar 12

Mansão Maromba Distribution Radar

#notion #ai #whatsapp #opensource

Overview

The Mansão Maromba Distribution Radar is an opinionated reference project that turns Notion into the source of truth for distribution mapping, prospecting, and messaging workflows — powered by Notion MCP, Visual Code, a mapping service, and WhatsApp bots.

It is designed as a portfolio-grade repo you can fork, adapt to your own brand, or use as a template for agentic distribution operations.

Core idea: Model everything in Notion (Mapa de Distribuição, Alvos de Prospecção, Backlog Radar Mansão Maromba), expose it via the official Notion MCP server, and orchestrate agents (schema/backlog, maps prospector, messaging assistant) from an MCP client.

Demo Video

Notion AI Agents

To automate and enhance distribution operations, the project uses specialized agents designed to interact with the Notion ecosystem:

🗺️ Mansão Maromba — Navigator

The lead agent responsible for operating the Distribution Map as a complete prospecting and CRM system. It discovers new points of sale (PDVs) via Google Maps API/MCP, automatically enriches records, maintains the sales funnel, and generates weekly executive summaries with key KPIs.

🎨 Master UI Agent

Focuses on user experience and data visualization. It transforms complex, data-heavy pages into minimalist, highly functional dashboards using custom Notion layouts, callouts, synced navigation, and curated database views.

📊 Amplitude Data Analyst

Bridges the gap between product usage and CRM. It analyzes Amplitude data and creates visual product usage reports directly within Notion to help prioritize high-potential leads.

📧 Email Assistant

Streamlines daily communication. During daily workflows, it integrates with all connected inboxes to ensure all incoming leads and responses are loaded, tracked, and ready for the next action.

High-Level Flows

1. Distribution Map + Dashboard (Notion-centric)

Notion databases model:

Current distribution presence by city/region and channel
Prospect targets with geo and business metadata
Backlog of experiments, campaigns, and ops tasks

The Schema/Backlog/PRD agent runs inside Antigravity (or another MCP client) and:

Validates that the Notion schema matches the spec
Creates/updates views and dashboards (funnels, regional overviews)
Maintains a living PRD/backlog inside Notion pages

2. Maps Prospecting Agent with MapOn.ai

A specialized MapsProspector agent that integrates with MapOn.ai:

Pulls location data from interactive MapOn.ai maps
Automatically identifies and filters bars and beverage establishments in Paraná
Creates prospects in Notion with ready-to-use call scripts for Mansão Maromba drinks
Filters out existing prospects to avoid duplicates

3. Messaging Assistant (WhatsApp Bot) — Future Integration

The system is designed to integrate a WhatsApp Messaging Assistant that will:

Connect to WhatsApp Business API (via Twilio or Meta) to initiate contact with prospects
Use AI to generate personalized messages based on prospect profiles stored in Notion
Synchronize inbound replies back to Notion with LLM-based categorization
Trigger follow-up sequences based on status changes in the Notion Kanban board

Architecture Overview

             +-------------------------+
             |   MCP Client / Cockpit  |
             |  (Visual Code, CLI,…)   |
             +-----------+-------------+
                         |
                         | MCP protocol
                         v
              +------------------------+
              |  Notion MCP Server     |
              | (@notionhq/notion-mcp) |
              +----+--------------+----+
                   |              |
         Notion API|              |HTTP/Webhooks
                   v              v
        +----------------+   +-------------------+
        |  Notion DBs    |   | External Services |
        | - Mapa Dist.   |   | - MapOn.ai        |
        | - Alvos Pros.  |   | - WhatsApp API    |
        | - Backlog      |   +---------+---------+
        +--------+-------+             ^
                 ^                     |
                 |                     |
        +--------+----------+   +------+----------------+
        | Paraná Bars        |   | Messaging Assistant   |
        | Prospector         |   | (WhatsApp bot)        |
        | (MapOn.ai API)     |   +-----------------------+
        +-------------------+

Tech Stack

JavaScript — 51.9%
TypeScript — 47.4%
Python — 0.7%
License: MIT

Getting Started

Fork the repo, plug in your own API keys (Notion, Google Maps, WhatsApp), and adapt the agent prompts to your brand. This repo ships prompts, config templates, and code skeletons — not production-ready bots.

GitHub: https://github.com/PauloTuppy/mansao-maromba-distribution-radar

DEV Community