MCP Tools — Detailed Reference

get_profile

Retrieves a subset of profile fields for a given DTX_ID.

Parameters:

{
  "dtx_id": "uuid-string",
  "fields": ["party.given_name", "account.value_tier", "traits.churn_probability_30d"]
}

Response:

{
  "dtx_id": "uuid-d001",
  "party": { "given_name": "[MASKED]" },
  "account": { "value_tier": "GOLD" },
  "traits": { "churn_probability_30d": 35 }
}

PII Masking

Personal identifiers are masked by default. Only aggregate/behavioral data is returned unmasked.

resolve_identity

Resolves any identifier to its DTX_ID.

Parameters:

{
  "identifier_type": "MSISDN",
  "identifier_value": "+971501234567"
}

get_segment_stats

Returns aggregate statistics without any PII.

Parameters:

{ "segment_id": "seg-001" }

Response:

{
  "segment_id": "seg-001",
  "name": "High Value Churn Risk",
  "member_count": 12453,
  "avg_churn_probability": 62.4,
  "avg_spend_30d": 385.20
}