list_issuesLABSCO SUMMARY
Trace a broken table up to its cause.
The lineage-plus-issues combination is what this has that a dashboard does not: an issue becomes traceable end to end rather than a row in a list. get_table_dimension_coverage answers the harder question, which is what you are not monitoring at all.
What it is
An MCP server for the Bigeye data observability platform, shipped as a Docker image. It reaches most of the platform: issues and incidents, metrics and profiling, the data catalog, lineage in both directions, dimension coverage, tags and the business glossary.
What you get
- Issues —
list_issues,get_issue,search_issuesby display number,list_table_issues,list_related_issuesvia lineage,update_issue,create_incidentby merging related issues,get_resolution_steps - get_current_user returns your id, which pairs with
list_issues(assignee_ids=[id])to find what is assigned to you - Metrics and profiling —
list_table_metrics,create_metricwith validation and column-type compatibility checks,get_table_profile,create_profile_job,get_profile_job_status - Lineage —
get_lineage_graphupstream, downstream or both,search_lineage_nodesby path pattern,get_lineage_node,list_lineage_node_issues - Root cause and impact —
get_upstream_root_causes,get_downstream_impact,get_issue_lineage_trace,list_report_upstream_issuesfor a BI report or dashboard - Catalog —
search_schemas,search_tables,search_columns,list_data_sources - Sensitive data —
list_data_classes,get_scan_findingsshowing where classified data was detected - Dimensions, tags and glossary — including
get_table_dimension_coveragefor answering "what monitoring is missing?" - Agent lineage tracking — record the data an agent touched with
lineage_track_data_access, thenlineage_commit_agentto persist it into the lineage graph
Requirements
Docker, plus BIGEYE_API_KEY generated under Settings > API Keys, BIGEYE_BASE_URL for your instance, and BIGEYE_WORKSPACE_ID, which is the number after /w/ in your Bigeye URL. BIGEYE_DEBUG turns on verbose logging and BIGEYE_TELEMETRY=false disables anonymous usage analytics — which record tool name, duration and success only, never arguments or results. The long-lived container path uses mcp-wrapper.sh with docker compose and expects the .env file beside docker-compose.yml; an ephemeral container per session is the alternative. Local development without Docker needs Python 3.12+.
Setup effort
Run a container — build the image from the repository, then point your client at it
USE CASES
Working through what is assigned to you
Get your user id, filter issues by it, and update status or priority as you go.
Finding out why a table went bad
Trace the issue through lineage and read the upstream root causes.
Deciding how urgent a data issue is
Check what depends on the node downstream, including affected BI reports.
Closing a monitoring gap
Look at dimension coverage for the table, then create the metric that fills it.
61 tools
Listed in project docs. Your client may show a different list.
get_current_userget_issuesearch_issueslist_related_issueslist_table_issuesupdate_issuecreate_incidentdelete_incident_membersget_resolution_stepslist_table_metricslist_table_level_metricscreate_metricget_table_profilecreate_profile_jobget_profile_job_statuslist_data_classesget_scan_findingssearch_schemassearch_tablessearch_columnsget_lineage_graphget_lineage_nodelist_lineage_node_issuessearch_lineage_nodeslineage_explore_cataloglineage_delete_nodeget_upstream_root_causesget_downstream_impactget_issue_lineage_tracelist_report_upstream_issueslineage_track_data_accesslineage_commit_agentlineage_get_tracking_statuslineage_clear_tracked_assetslineage_cleanup_agent_edgeslist_dimensionsget_dimensioncreate_dimensionupdate_dimensiondelete_dimensionget_table_dimension_coverageget_column_dimension_coveragelist_tagscreate_tagupdate_tagdelete_tagtag_entityuntag_entitylist_entity_tagslist_glossary_termscreate_glossary_termupdate_glossary_termdelete_glossary_termlink_glossary_term_to_entityunlink_glossary_term_from_entityget_glossary_term_linksget_entity_glossary_termsget_health_statuslist_resourceslist_data_sourcesBEFORE YOU INSTALL
What to know first
Tools you get
61 tools named in the project's documentation.
Requires
- BIGEYE_API_KEY in your environment
- BIGEYE_BASE_URL in your environment
- BIGEYE_WORKSPACE_ID in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Build the image from the repository, then point your client at it.
Server setup
git clone https://github.com/bigeyedata/bigeye-mcp-server.git
cd bigeye-mcp-server
./build-docker.sh
cp .env.example .env
./bigeye-mcp.sh startMCP Clients
Claude Desktop
{
"mcpServers": {
"bigeye": {
"command": "<YOUR_PATH_TO_MCP_WRAPPER>"
}
}
}The configuration on this page does not set BIGEYE_API_KEY, BIGEYE_BASE_URL, BIGEYE_WORKSPACE_ID. This project documents supplying them in a .env file in the project directory, outside the block.