Contact Environment

Environment Configuration

Location: /opt/mcp-servers/contact/mcp_contact_server.py
Version: 2.1.0-enterprise (2025-12-03)
Vault Port: 6630 (master, requires password)
Operational Port: 6631 (reads, no password)
Locker ID: l_17c6

Purpose

Enterprise CRM contact management with: - Stable IDs (c_XXXX format - 4-digit alphanumeric, 1.68M capacity) - Track Pattern: contact:{owner}:{timestamp}:contact:c_XXXX - Sharing model: users, teams, visibility (private/shared/public) - Relationships: professional, personal, networking graphs - Multi-resolution: stable_id → email → name lookup - Quadfecta intelligent search scoring - FalkorDB Layer 3 graph indexing

Tools (12 total)

Tool	Description	Required Params
`create`	Create new contact	name OR firstName/lastName
`get`	Get contact by ID/email/name	id (required)
`search`	Search with Quadfecta scoring	query (required)
`list`	List all contacts	limit (default 50)
`update`	Update contact fields	id (required)
`delete`	Delete contact	id, confirm=true
`batch_create`	Create multiple contacts	contacts[]
`batch_get`	Get multiple contacts	ids[]
`batch_update`	Update multiple contacts	updates[]
`batch_delete`	Delete multiple contacts	ids[]
`add_category`	Add contact category	name, description
`get_categories`	List all categories	none

Contact Fields

name / firstName / lastName - Auto-parses "Full Name" format
email - Primary email address
phone - Phone number
company - Company/organization
title - Job title
website - Website URL
notes - Free-form notes
linkedData - External data links

Architecture

Redis Indexes

contact:id_index (hash) - stable_id → contact_key mapping
contact:email_index (hash) - email → contact_key mapping
contact:name_index (hash) - fullName → contact_key mapping
contact:synaptic:index (hash) - Quadfecta search index

Key Pattern

contact:{owner}:{YYYYMMDD_HHMM}:contact:c_XXXX

Integrations

Quadfecta scorer for intelligent search
Graph helper for FalkorDB Layer 3
Credentials helper for secure password retrieval

Security Assessment

✅ Uses credentials_helper for password retrieval from Locker (l_17c6) ✅ Vault (6630) requires password authentication ✅ Operational (6631) is read-only, no password required ✅ No SQL injection risk (Redis-based) ✅ No command injection vectors found

⚠️ Hardcoded fallback password: 'z7XGXX' (line 71) - acceptable as fallback ⚠️ Both ports show connected_slaves:0 - dual-master design

Current Data

Total keys: 13
Active contacts: 4 (c_e7c4, c_dn9d, c_rirf, c_dfze)
Legacy contacts: 1 (f68b8e75 format)

Test Results

✅ Redis 6630 (vault): Responding ✅ Redis 6631 (operational): Responding ✅ contact.list: Working - returned 4 contacts ✅ contact.get: Working - resolved by stable_id ✅ contact.search: Working - Quadfecta scoring active ⚠️ Categories: None configured (feature available but unused)

Status: WORKING

Contact environment fully operational with secure credential management.