> ## 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_create_watchlist

> Create a watchlist in Bigdata.com from a name and a list of companies or securities.

## Overview

The `bigdata_create_watchlist` tool creates a new watchlist in your Bigdata.com account from a display name and a list of **Knowledge Graph IDs**. The watchlist is owned by the caller and appears immediately in the Bigdata App under Watchlists, where it can be opened, shared, and used like any watchlist created in the product.

The returned watchlist `id` is the handle for every follow-up: fetch it with [`bigdata_get_watchlist`](/mcp-reference/tools/bigdata-get-watchlist), change it with [`bigdata_edit_watchlist`](/mcp-reference/tools/bigdata-edit-watchlist), or remove it with [`bigdata_delete_watchlist`](/mcp-reference/tools/bigdata-delete-watchlist).

## When to Use

Create Watchlist is ideal for:

* **Importing a portfolio:** Turning a spreadsheet, PDF, or pasted list of holdings into a watchlist your agent can revisit
* **Saving a screen:** Persisting the output of [`bigdata_screen_companies`](/mcp-reference/tools/bigdata-screen-companies) or a peer set so it can be monitored later
* **Building a comps set:** Keeping a group of competitors together for recurring tearsheets and searches

<Tip>
  Items must be Knowledge Graph IDs, not company names or tickers. Resolve names, tickers, and themes with [`find_securities`](/mcp-reference/tools/find-securities), or exact ISIN, CUSIP, SEDOL, and listing codes with [`get_securities`](/mcp-reference/tools/get-securities), before calling this tool.
</Tip>

## How It Works

1. **Resolve** each company or security to its Knowledge Graph ID with `find_securities` or `get_securities`
2. **Extract** the `id` field from each result
3. **Call** `bigdata_create_watchlist` with a `name`, an optional `description`, and the list of IDs in `items`
4. **Keep** the returned watchlist `id` for later reads, edits, deletes, and for the Bigdata App

## Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `name` | string | Yes | Display name for the new watchlist. |
| `items` | string\[] (1-100 unique items) | Yes | Knowledge Graph IDs to store on the watchlist. Each ID is exactly 6 alphanumeric characters (for example `["D8442A", "228D42"]`). Duplicates are removed before the watchlist is created. |
| `description` | string | No | Short description shown alongside the watchlist. |

### Important Notes

* A watchlist created through this tool holds at most **100 unique IDs**. Watchlists created in the Bigdata App can be larger, and `bigdata_get_watchlist` still returns all of their items
* Duplicate IDs are collapsed, so the returned `items` may be shorter than the list you sent
* Category, sharing, and global or thematic settings cannot be set through this tool. Manage them in the Bigdata App

## Data Returned

Returns a JSON object with a `watchlists` array containing the newly created watchlist:

| Field | Description |
| - | - |
| `id` | Watchlist ID. Use it with the other watchlist tools |
| `name` | Display name |
| `description` | Description, or `null` when none was given |
| `items` | Deduplicated Knowledge Graph IDs stored on the watchlist |

```json theme={null}
{
  "watchlists": [
    {
      "id": "ea4c5039-6edb-45c1-9c51-37d3ab9689b0",
      "name": "US mega-cap tech",
      "description": "Core large-cap technology holdings",
      "items": ["228D42", "D8442A"]
    }
  ]
}
```

## Usage Monitoring

The tool `bigdata_create_watchlist` does not consume any quota.

## Practical Tips

### Next steps after creating

Pass the returned `items` to [`bigdata_portfolio_tearsheet`](/mcp-reference/tools/bigdata-portfolio-tearsheet) for a one-row-per-company grid of price, EPS, price target, and sentiment across the whole watchlist.

### Larger lists

For lists above 100 securities, create the watchlist with the first 100 IDs and grow it with [`bigdata_edit_watchlist`](/mcp-reference/tools/bigdata-edit-watchlist), or build it in the Bigdata App.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.