---
title: "Ecosystem MCP — Business Intelligence Tools"
slug: ecosystem-mcp-bi-tools
section: Integrations
status: stable
description: "Reference for the 6 live BI and operational tools exposed by the upstream MCP server."
last-updated: 2026-10-07
---

# Ecosystem MCP — Business Intelligence Tools

Reference for the 6 live BI and operational tools exposed by the upstream MCP server.

## Overview

In addition to the AI Connector surface, the upstream MCP server exposes 6 Business Intelligence (BI) and operational tools. These tools provide real-time visibility into the GLOBUS business pipeline, ecosystem health, and operational queues.

## Privacy Model: k-anonymity

Both aggregateQuery and query_globus_data implement strict privacy controls. They enforce a k-anonymity model with a minimum group size of 5 (minGroupSize=5).

- Any cohort containing fewer than 5 individuals is suppressed from the results to prevent re-identification.
- The response includes a count of hidden groups.
- These tools strictly return aggregate counts—no per-person data, averages, or sums are permitted.
## Operational Health Tools

### getEcosystemHealth

Returns overall ecosystem health including portal sync status, stale/never-seen portals, pipeline freshness, and open issues.

Schema: status: string,

issues: string[],

stalePortals: Portal[],

neverSeenPortals: Portal[],

neverSyncedPortals: Portal[],

pipelineAgeHours: number,

hubStateKeyCount: number,

generatedAt: string

### getExceptions

Returns live exception/error counts and recent exceptions logged across the ecosystem, broken down by severity and status.

## Pipeline & Analytics Tools

### getPipelineSummary

Returns the latest published GLOBUS pipeline summary including candidate counts and stage breakdowns.

Schema: pipeline: data: hosts: object,

totals: object,

matches: object,

by_stage: object,

applicants: object,

by_program: object,

job_orders: number,

placements: object,

by_visa_type: object,

reservations: object,

active_programs: number

### aggregateQuery

Answers ad-hoc plain-English questions about the GLOBUS business (e.g., "how many applicants by country"). Returns grouped counts and a written answer, subject to k-anonymity.

### query_globus_data

Runs a structured aggregate query against the business database specifying entity ('applicants', 'hosts', 'placements'), dimensions, and optional filters. Subject to k-anonymity.

## Business Queues

### getBusinessQueue

Returns work-queue depth and a sample of items. Filters available by queueName, status, program, or visaType.

Live Queues:

- globus_exception_resolution: Holds system exceptions generated by GLOBUS requiring manual intervention.
- exception_resolution: Holds general system exceptions (often from n8n automations) requiring manual intervention.