> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bigdata_list_connectors

> List private content connectors for corpus structure discovery.

## Overview

List Private Content Connectors returns all private content connectors the user can access — Email, Investment Research, and SharePoint. It is the starting point for understanding which private sources are connected before browsing documents or searching within a specific connector.

## When to Use

List Private Content Connectors is ideal for:

* **Source inventory:** Seeing which email, broker research, and SharePoint connectors are available
* **Corpus discovery:** Understanding connected sources before searching private content
* **Connector status:** Checking last sync time, document counts, and sync health
* **Scoped follow-ups:** Resolving a connector `label` or `connector_id` for document listing or tag-scoped search

## How It Works

1. Call `bigdata_list_connectors` — no parameters required
2. Review each connector's type, label, document count, and last sync status
3. Use the returned `connector_id` with [`bigdata_list_documents`](/mcp-reference/tools/bigdata-list-documents), or the `label` to scope [`bigdata_search`](/mcp-reference/tools/bigdata-search) with a `label:` tag

## Parameters

This tool takes no parameters.

## Data Returned

An array of connector objects:

| Field                       | Description                                                                                           |
| --------------------------- | ----------------------------------------------------------------------------------------------------- |
| `connector_id`              | Connector UUID                                                                                        |
| `label`                     | Display label — also used as the `label:<label>` auto-tag on documents ingested through the connector |
| `type`                      | `email`, `investment_research`, or `sharepoint`                                                       |
| `description`               | Optional description                                                                                  |
| `share_with_org`            | Whether content is shared with the organisation                                                       |
| `archived`                  | Whether the connector is archived                                                                     |
| `files_count`               | Number of ingested files                                                                              |
| `last_sync_at`              | Timestamp of the last sync                                                                            |
| `last_sync_status`          | Outcome of the last sync                                                                              |
| `last_sync_error_msg`       | Error message when the last sync failed                                                               |
| `last_sync_count`           | Items processed in the last sync                                                                      |
| `created_at` / `updated_at` | Timestamps                                                                                            |

## Practical Tips

### Reading sync status

* Focus on active connectors when summarizing sources; archived connectors are usually less relevant unless reviewing inactive sources
* `FAILURE` or `DISABLED` on `last_sync_status` means the connector needs attention — `DISABLED` indicates repeated sync failures that caused the system to disable it

### Searching within a connector

The connector `label` maps to an auto-tag on ingested documents. Scope search with that label — for example, pass `tags: label:Legal` in the [`bigdata_search`](/mcp-reference/tools/bigdata-search) context when exploring content from a connector labeled "Legal".

### From connectors to documents

Use [`bigdata_list_documents`](/mcp-reference/tools/bigdata-list-documents) with the returned `connector_id` to browse files from a specific source, or [`bigdata_list_tags`](/mcp-reference/tools/bigdata-list-tags) with `prefix="label:"` to see connector labels as tags.