# cupix-compass MCP server

Explore and analyze Cupix construction site data: 360 images, progress, and insights.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-andrew-ji-cupix-cupix-compass

## Install
- Endpoint: https://7qc1f4ft9d.execute-api.us-west-2.amazonaws.com/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://7qc1f4ft9d.execute-api.us-west-2.amazonaws.com/mcp

## Tools
- listFacilities - 
List construction facilities (projects) the user can access within a team.
Each facility is returned with its name and facility_key.
**Required workflow:**
1. Present the returned facilities to the user.
2. Wait for the user to select one or more facilities.
3. Only then invoke search or analysis tools with the chosen facility_key(s).
**Important:** Never skip team selection—always call list_teams() first.

Args:
    team_domain: Team domain returned by list_teams(). Optional; if omitted,
        the team list is returned instead.

Returns:
    str: Accessible facilities with their keys and names.
 Endpoint: https://7qc1f4ft9d.execute-api.us-west-2.amazonaws.com/mcp
- projectDataExplorer - 
Query structured project data using natural language (Text-to-SQL).
Converts natural language into SQL to retrieve project records, statistics, and aggregations.
Pass the user's question as-is without modification.
For trade visibility, use siteinsightsAnalyzer instead.
**WORKFLOW:** list_facilities() → ask user to select → call this tool
**Available tables:**
- progresses: SI progress metrics (level, category, phase, workarea, cost, dates)
- captures: Camera captures metadata (level, camera_model, capture_state, user_email)
- records: Capture events with timestamps (captured_at, state, id)
- photo_notes: Photonotes (description, state, user_email, created_at)
- voice_notes: Voicenotes (level, description, state, user_email, created_at)
- facilities: Site info (name, address, size, location, bim_count, created_at)
- users: User profiles (name, email)
- workareas: Spatial zones (level, name, user_name)

Args:
    query: Natural language question (pass as-is, no SQL syntax)
    team_domain: Team domain (REQUIRED)
    facility_key: Facility key (REQUIRED - from list_facilities())

Returns:
    Query results as tab-separated text
 Endpoint: https://7qc1f4ft9d.execute-api.us-west-2.amazonaws.com/mcp
- siteImageExplorer - 
Search panoramic 360-degree site images by visual content analysis.
Searches what is VISUALLY SEEN in site images — safety hazards, quality issues, work types,
objects, equipment, materials, and physical site conditions.
Do NOT use for capture counts or statistics — use project_data_explorer instead.
**WORKFLOW (MUST FOLLOW):**
1. Call list_facilities() to get accessible facilities
2. Ask the user which facility to search (all or specific)
3. Call this tool with the chosen facility_key
**Date filtering:** Only use start_date/end_date when the user explicitly mentions dates.
Format: YYYY-MM-DD. Omit entirely for general queries without date context.

Args:
    query: Keywords or phrases describing what to find in site images
    team_domain: Team domain (REQUIRED)
    facility_key: Facility key (REQUIRED - from list_facilities())
    limit: Maximum number of results (default: 10)
    start_date: Start date filter, YYYY-MM-DD (omit if no date context)
    end_date: End date filter, YYYY-MM-DD (omit if no date context)

Returns:
    ToolResult: Image viewer links, 3D coordinates, and capture dates
 Endpoint: https://7qc1f4ft9d.execute-api.us-west-2.amazonaws.com/mcp
- siteinsightsAnalyzer - 
Analyze SiteInsights(SI) progress — completion rates, delays, and forecasts.
Generates a progress report: overall completion, progress by category/vendor/level,
delay analysis, and estimated completion dates.
**WORKFLOW:** list_facilities() → ask user to select → call this tool

Args:
    team_domain: Team domain (REQUIRED)
    facility_key: Facility key (REQUIRED - from list_facilities())

Returns:
    Progress analysis report with completion rates and forecasts
 Endpoint: https://7qc1f4ft9d.execute-api.us-west-2.amazonaws.com/mcp

## Resources
- ui://siteImageExplorer/view.html - HTML widget for siteImageExplorer tool results. MIME type: text/html;profile=mcp-app
- ui://siteinsightsAnalyzer/view.html - HTML widget for siteinsightsAnalyzer tool results. MIME type: text/html;profile=mcp-app

## Prompts
- analyze-site-progress - Analyze construction progress for a facility: completion rates by trade, delays, forecasts, and trade visibility across work areas. Arguments: team_domain, facility_key, period
- find-safety-hazards - Search 360° site images for safety hazards and non-compliance issues, and summarize findings by area. Arguments: team_domain, facility_key, area
- generate-site-report - Generate a comprehensive site report covering progress, trade visibility, data queries, and visual findings for a facility. Arguments: team_domain, facility_key

## Metadata
- Owner: io.github.andrew-ji-cupix
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Apr 27, 2026
- Source: https://registry.modelcontextprotocol.io