# Tools Reference
Complete reference for all 54 tools available in the MCP GA4 Ultimate server.
## Phase 1: Advanced Reporting (8 tools)
### Basic Analytics
- `get_basic_metrics` - Core GA4 metrics (users, sessions, pageviews, bounce rate)
- `get_top_pages` - Most visited pages with traffic data
- `get_traffic_sources` - Traffic sources breakdown and performance
### Advanced Reports
- `run_realtime_report` - Real-time data (up to 29 minutes for standard properties)
- `run_pivot_report` - Cross-dimensional analysis with pivot tables
- `run_funnel_report` - Conversion funnel analysis
- `run_batch_reports` - Multiple reports processing automation
### Utility
- `help` - Server capabilities and usage information
## Phase 2: Configuration Management (13 tools)
### Custom Dimensions
- `create_custom_dimension` - Create new custom dimensions
- `get_custom_dimension` - Retrieve dimension details
- `list_custom_dimensions` - List all custom dimensions
- `update_custom_dimension` - Modify existing dimensions
- `archive_custom_dimension` - Archive unused dimensions
### Custom Metrics
- `create_custom_metric` - Create new custom metrics
- `get_custom_metric` - Retrieve metric details
- `list_custom_metrics` - List all custom metrics
- `update_custom_metric` - Modify existing metrics
- `archive_custom_metric` - Archive unused metrics
### Conversion Events
- `create_conversion_event` - Configure new conversion goals
- `list_conversion_events` - List all conversion events
- `delete_conversion_event` - Remove conversion events
## Phase 3: Platform Integrations (15 tools)
### Google Ads Integration
- `list_google_ads_links` - Connected Google Ads accounts
- `create_google_ads_link` - Link new Google Ads account
- `delete_google_ads_link` - Remove Google Ads connection
- `analyze_google_ads_performance` - Campaign performance analysis
### BigQuery Integration
- `list_bigquery_links` - Connected BigQuery projects
- `create_bigquery_link` - Link BigQuery for data export
- `delete_bigquery_link` - Remove BigQuery connection
### Data Streams
- `list_data_streams` - All configured data streams
- `create_data_stream` - New platform tracking setup
- `update_data_stream` - Modify stream configuration
- `delete_data_stream` - Remove data stream
### Measurement Protocol
- `send_measurement_event` - Server-side event tracking
- `validate_measurement_event` - Event validation
- `batch_measurement_events` - Bulk event processing
- `get_measurement_settings` - Protocol configuration
## Phase 4: Compliance & Privacy (10 tools)
### GDPR & Privacy
- `create_user_deletion_request` - GDPR data deletion
- `list_user_deletion_requests` - Track deletion requests
- `get_user_deletion_request` - Request status details
### Data Retention
- `get_data_retention_settings` - Current retention policies
- `update_data_retention_settings` - Modify retention periods
### Access Management
- `list_account_summaries` - Account access overview
- `get_property_details` - Property configuration
- `list_properties` - Available properties
- `get_account_details` - Account information
- `list_users` - User access management
## Phase 5: Business Intelligence (8 tools)
### Attribution Analysis
- `run_attribution_report` - Multi-touch attribution
- `compare_attribution_models` - Model comparison
- `get_attribution_settings` - Current attribution config
### Audience Management
- `list_audiences` - Configured audience segments
- `create_audience` - New audience definition
- `update_audience` - Modify audience criteria
### Advanced Analytics
- `run_predictive_analysis` - ML-powered insights
- `generate_custom_dashboard` - Automated reporting
## Usage Examples
### Basic Query
```python
# Get basic metrics for last 30 days
result = mcp_server.get_basic_metrics(days=30)
```
### Real-time Monitoring
```python
# Monitor current activity
realtime_data = mcp_server.run_realtime_report(minutes=15)
```
### Configuration
```python
# Create custom dimension
dimension = mcp_server.create_custom_dimension(
display_name="User Engagement Level",
description="Custom engagement scoring",
scope="EVENT"
)
```
### GDPR Compliance
```python
# Process deletion request
deletion = mcp_server.create_user_deletion_request(
user_id="user123"
)
```
## Error Handling
All tools include comprehensive error handling:
- API authentication errors
- Invalid parameter validation
- Rate limiting management
- Graceful fallbacks
## Testing Status
Current testing coverage: **92.3%** (50/54 tools)
✅ **Passing**: 50 tools fully validated
⚠️ **Pending**: 4 tools with minor configuration issues
