.env.tools.example

# Countly MCP Server - Tools Configuration Examples
# 
# Control which tool categories and CRUD operations are available
# Format: COUNTLY_TOOLS_{CATEGORY}={OPERATIONS}
# Operations: C (Create), R (Read), U (Update), D (Delete)
#
# Examples:
#   CRUD or ALL or * = All operations enabled (default)
#   CR = Only Create and Read
#   R = Only Read (read-only mode)
#   NONE or empty = Disable category completely

# =============================================================================
# DEFAULT CONFIGURATION (if not specified, all operations are allowed)
# =============================================================================

# Set default for all categories (can be overridden per category below)
# COUNTLY_TOOLS_ALL=CRUD

# =============================================================================
# CATEGORY-SPECIFIC CONFIGURATION
# =============================================================================

# Core Tools (search, fetch) - Required for ChatGPT Connectors
# These are read-only tools, typically should not be disabled
# COUNTLY_TOOLS_CORE=R

# Apps Management (apps_list, apps_get_by_name, apps_create, apps_update, apps_delete, apps_reset)
# Example: Allow read and create, but not update or delete
# COUNTLY_TOOLS_APPS=CR

# Analytics & Dashboards (get_analytics_data, dashboards_data, get_events_data, slipping_users, etc.)
# Typically read-only
# COUNTLY_TOOLS_ANALYTICS=R

# Crash Analytics (crash_groups_list, crashes_get, add/edit/delete comments, resolve, etc.)
# Example: Allow read and comment creation, but not editing or deleting
# COUNTLY_TOOLS_CRASHES=CR

# Notes Management (notes_list, notes_create, notes_delete)
# COUNTLY_TOOLS_NOTES=CRD

# Events Configuration (events_create)
# COUNTLY_TOOLS_EVENTS=C

# Alerts Management (alerts_list, alerts_create, alerts_delete)
# COUNTLY_TOOLS_ALERTS=CRD

# Views Analytics (views_table, views_segments, views_data)
# COUNTLY_TOOLS_VIEWS=R

# Database Operations (databases_query, databases_list, databases_document, etc.)
# Example: Read-only database access
# COUNTLY_TOOLS_DATABASE=R

# Dashboard User Management (dashboard_users)
# Returns dashboard/admin users who access the Countly dashboard
# COUNTLY_TOOLS_DASHBOARD_USERS=R

# App User Management (apps_create_user, apps_delete_user, export_app_users)
# Manages end-users of applications being tracked by Countly
# COUNTLY_TOOLS_APP_USERS=CRD

# =============================================================================
# EXAMPLE CONFIGURATIONS
# =============================================================================

# Example 1: Read-only mode for everything
# COUNTLY_TOOLS_ALL=R

# Example 2: Full access to analytics and crashes, read-only for apps
# COUNTLY_TOOLS_ANALYTICS=R
# COUNTLY_TOOLS_CRASHES=CRUD
# COUNTLY_TOOLS_APPS=R

# Example 3: Disable database and user management completely
# COUNTLY_TOOLS_DATABASE=NONE
# COUNTLY_TOOLS_DASHBOARD_USERS=NONE
# COUNTLY_TOOLS_APP_USERS=NONE

# Example 4: Allow everything except deletion operations
# COUNTLY_TOOLS_ALL=CRU