MCPServer
Connect Claude to EkoParty party management and agenda using the Model Context Protocol.
Requirements
Node.js 18 or higher and Claude Desktop with MCP support.
1. Clone the repository
git clone https://gitlab.com/faradaysec/eko-party.git
cd eko-party2. Install MCP server dependencies
cd mcp
npm install3. Configure Claude Desktop
Edit (or create) the Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"eko-party": {
"command": "node",
"args": ["/RUTA/A/eko-party/mcp/server.mjs"],
"env": {
"SUPABASE_URL": "https://xoyklzqycjgwlmspmjdi.supabase.co",
"SUPABASE_KEY": "sb_publishable_5kLgKgcVfJqsxleOU0eICw_oivAxDYk",
"WHALEMATE_API_KEY": "TU_API_KEY_DE_WHALEMATE"
}
}
}
}Replace /PATH/TO/ with the absolute path to the cloned directory.
4. Restart Claude Desktop
Close and reopen Claude Desktop. The eko-party server will appear in the tools panel (plug icon).
Available tools
Ask Claude any of these actions in natural language:
list_partiesList parties filtered by edition and status (pending / approved / rejected).
get_partyGet full details of a party by UUID.
get_pending_partiesReturns the moderation queue: parties awaiting approval.
submit_partySubmit a new party to the listing (stays "pending" until approved).
approve_partyApprove a pending party so it appears on the public listing.
reject_partyReject a pending party with an optional reason.
fetch_eko_agendaAttempts to fetch the agenda from ekoparty.org/agenda-2026/ (best-effort — page is JS-rendered).
Whalemate integration
Tools to query the Whalemate phishing-simulation and awareness platform. Requires WHALEMATE_API_KEY (generate it in Settings → Integrations → API Keys at app.whalemate.com):
whalemate_list_employeesLists company employees with filters by name, email, department, country and position.
whalemate_get_employee_eventsPhishing-simulation events for one employee (email sent, click, report) with campaign info.
whalemate_list_campaignsPhishing campaigns with full statistics: sent, opened, clicked, reported, failed.
whalemate_get_campaign_eventsEvents of a specific campaign: who opened, clicked, reported or failed, with victim details.
whalemate_get_reported_emailsEmails reported by employees, grouped by status (received, in review, resolved).
whalemate_get_reported_emails_analyticsWeekly reported-email metrics: totals by category (clean/spam/threat) and status.
whalemate_get_course_inscriptionsSecurity-awareness (Academy) course inscriptions with filters by employee, team and dates.
Source code
The MCP server and the full application are open source:
View on GitLab →