CB Insights

Predict when companies will raise their next funding round (funding window, fundraise timing, likelihood to raise, next round prediction). Returns the predicted fundraising window (start and end date), the company's current phase relative to that window (pre/in/post), the peer cohort of similar companies used to derive the prediction, the percentage of peer companies that historically raised a next round, and the median days to next funding. Use preset='full' to also include the time-to-funding histogram.

get_company_funding_window

Return structured quantitative metrics about a company's employee count and open job postings. Use when the user asks for specific numbers such as headcount, headcount growth rates, number of open positions, or momentum score. Do NOT use for questions about hiring strategy, workforce strategy, talent philosophy, workforce trends, or hiring outlook — use `get_company_hiring_insights` for those. Fields returned: - total_headcount, total_headcount_as_of: most recent total employee count and the date it was measured. - six_month_growth_pct, one_year_growth_pct, two_year_growth_pct: headcount growth over the trailing 6 months / 1 year / 2 years, as a percentage. - headcount_history: monthly total headcount over the past 2 years (oldest to newest). Each point has as_of_date, headcount, and percent_change_pct (change from the prior data point, when available). - department_distribution, country_distribution: object with as_of_date and a points list. Each point has name, headcount, and pct_of_total (the headcount as a percentage of the sum of all categorized headcounts in that distribution; sums to ~100). Sorted by headcount descending. - open_positions: count of open job postings for the most recent target month. - target_month: month that hiring stats (open positions, momentum) were captured. - hiring_intensity: percentage of open job positions to total headcount, indicating the company's hiring rate relative to its current workforce size. - momentum_score: a CBI proprietary index used to compare hiring activity across companies, accounting for company size. A larger company hiring at the same rate of job openings as a percentage of total headcount will have a higher momentum score than a smaller company with the same rate. The average momentum score is around 5 out of 100. - momentum_score_percentile: the percentile ranking of a company's momentum score compared to all other companies in the dataset, indicating what percentage of companies have lower momentum scores. For example, a company in the 99th percentile means 99% of other companies have lower momentum scores, placing it in the top 1% of hiring momentum.

get_company_headcount

Return AI-generated narratives about companies' hiring activity, talent strategy, workforce trends, and hiring outlook, based on CB Insights analysis.

get_company_hiring_insights

For each of the requested companies or investors, returns its investments (rounds it has backed, led, or co-invested in), including the portfolio company, round type, date, and amount. To filter investments across investors with 50+ attribute filters, use the `search_deals` tool.

get_company_investments

For each of the requested companies, returns the investors (e.g. VCs, angels, lead investors, participating investors, backers) who have funded it, including round participation details and lead investor status. To filter investors by type, geography, fund size, or 50+ other attributes, use `search_investors` instead.

get_company_investors

For each of the requested companies, returns the market maps (e.g. industry landscapes, sectors, ESP categories, verticals, segments) that include it, with the market name, description, and associated industries.

get_company_markets

For each of the requested companies or investors, returns recent news articles (e.g. press releases, announcements, headlines, media coverage, mentions), including dates, titles, content snippets, source URLs, and other organizations mentioned in the same articles.

get_company_news

For each of the requested companies, returns forward-looking outlook data: Mosaic scores (with insights, percentiles, and 1-year deltas), exit probability (IPO/M&A) with contributing signals, and commercial maturity / technology readiness levels (TRL). Mosaic is a 0-1000 health/growth score for private companies (>600 signals a higher likelihood of IPO, unicorn status, or favorable exit).

get_company_outlook

Return profile overviews for companies or investors: name, description, website, HQ location, founded year, status (e.g. alive, acquired, IPO, dead), total funding, Mosaic score, headcount, sector/industry classification, market maps, and the CB Insights analyst rating when available. Use this to look up a single company/investor, or to fetch many at once — e.g. to populate a table or compare a set of companies side by side. To find or filter companies and investors by 50+ attributes (rather than look up ones you can already name or identify), use `search_companies` or `search_investors`. Guidance: - profile.analyst_rating is written by human CB Insights analysts. Attribute it to them, never as your own view; quote its text verbatim rather than paraphrasing; and when you surface only part of the note, point to the rest at `citation.url` in your own words. Call `get_company_analyst_ratings` for the rating change history.

get_company_profile

For each of the requested companies, returns its business relationships (e.g. partnerships, suppliers, customers, vendors, licensees), ordered by recency. To filter by relationship type (i.e. client of company, integration partners), industry, or 50+ attributes to find connections between specific companies, use `search_partnerships` instead.

get_company_relationships

For each of the requested companies, returns revenue data, including estimated and reported revenue figures, revenue ranges, and historical revenue when available.

get_company_revenue

Get a strategy map showing a company's partnerships, investments, and acquisitions. Returns the company's strategic relationships grouped into AI-generated categories. Each company in the map includes relationship type (acquisition, investment, or partnership), connection date, headline, and details. The companion MCP App renders this as an interactive visual map with the anchor company on the left and categories branching to the right, with color-coded chips for each relationship type. Examples: get_company_strategy_map(id_org=12345) get_company_strategy_map(org_name="Menlo Ventures") get_company_strategy_map(org_name="Stripe") Keywords: strategy map, strategic, ecosystem, themes, categories, relationships, partnerships, investments, acquisitions, M&A, portfolio, alliances, deals, business development, positioning, focus areas.

get_company_strategy_map

Return the full transcript for a single earnings call (quarterly results, analyst call, investor call) for a public company, including all speaker paragraphs in order. Defaults to the most recent earnings call. To compare multiple earnings periods, call this tool in parallel once per period.

get_earnings_call_transcript

Report how many CB Insights MCP tool calls the current user has made and how many their plan allows. Use this when asked about usage, remaining tool calls, quotas, limits, or after a call is rejected for exceeding an allowance. Returns a daily per-user figure and an annual figure for the user's team (or, for an account with no team, an annual figure for the account itself), each with the number of calls used, the limit, and the window it applies to. Keywords: usage, quota, limit, allowance, remaining calls, rate limit, how many calls, over limit, exceeded.

get_usage

Returns an overview of a technology market or industry sector: market name, description, and key features; the list of companies / competitors in the market ranked by CBI Mosaic score (company health/momentum), each with CBI's scorecard analysis (competitive analysis, customer outcomes, etc.); and market trends including industry and sub-industry classification, equity funding totals and deal counts over 1-year and 2-year windows, average Mosaic score, commercial maturity stage, average employee headcount and headcount growth, a multi-year equity-funding-and-deals time series, and recent exit activity (IPOs / acquisitions). Use this to research a market's size, funding activity, competitive landscape, top startups, and growth trends. Accepts either a known market id or a market name (resolved against the CBI market taxonomy).

get_market

The CB Insights data columns that can be added to a watchlist. Use this to find the `id_column_type` to pass to add_watchlist_column with type='cbi'. Columns are grouped by category, and a column is identified by its id, not its name. `already_added` marks the columns the watchlist already shows. Adding one again is a safe no-op rather than an error. A search that matches nothing returns no categories and says so in `note`. Covers CB Insights data columns and the audit columns (Added date, Added by). Custom columns you fill in yourself are not listed here; create those with add_watchlist_column and type 'text', 'select', 'number' or 'date'. Readable for any watchlist, but add_watchlist_column refuses a watchlist with no companies in it.

get_watchlist_column_catalog

Fetch the organizations in a specific watchlist, by id_list or name. The default 'orgs' preset returns lightweight org records (id_org, name, url, status, latest funding) for the requested page plus the total member count. The 'table' preset adds `columns` (the watchlist columns) and a `cells` map of values per row. Pass the id_orgs to the `get_company_*` tools for full data. Only approved members are returned — the same set the user sees when they open the watchlist in the app. Both removed (rejected/deleted) entries and pending suggestions (not yet approved or rejected) are excluded.

get_watchlist_contents

Return the current user's watchlists, selected by a ListSet. Each watchlist comes back as {id_list, name, type (custom/competitors), item_count, is_pinned, permission_level, can_rename, watchlist_url}, where watchlist_url links to the watchlist in the CB Insights app. With no selector (or an empty one) this lists all of your watchlists; with containing_orgs it finds which of your watchlists contain those orgs. Use a returned id_list with `get_watchlist_contents` to see its members, or with the `get_company_*` tools' `selector.watchlist_ids`. `item_count` counts approved orgs, pending suggestions (not yet approved or rejected), and non-org rows such as people — so it can be larger than `get_watchlist_contents`'s `total` for the same watchlist, which counts approved orgs only: the same set the user sees when they open the watchlist in the app. Removed orgs count toward neither. `permission_level` is your access to the list — owner for your own lists, read_write or read for one shared with you. `can_rename` tells you whether `rename_watchlist` will accept it: false for a read-only share and for the auto-generated competitors list. The two `can_rename: false` cases differ for membership edits, though: the competitors list still accepts `add_watchlist_orgs` / `remove_watchlist_orgs`, but a read-only share (`permission_level: "read"`) refuses those too — only `permission_level: "read_write"` or `"owner"` can edit a list's members. Unresolvable watchlist references (list_names, list_ids) or org references (containing_orgs) are reported in `errors` with near-matches where available and don't fail the rest. An id_list you don't own comes back as an error, not as an empty result — so an empty `watchlists` with no `errors` genuinely means the selection matched nothing.

get_watchlists

Fetch a page of results from an existing company search. Use this after the initial search to page through results beyond the initial limit, or to re-sort without re-running the search. Pass the search_id returned by the initial search along with limit and offset. Only pass a sort_field to re-sort; omit it and pagination keeps the search's default (relevance) order.

paginate_and_sort_search

Rename a watchlist (targeted by id_list or its current name). Requires that you own the watchlist or hold write permission on it. The auto-generated competitors watchlist can't be renamed.

rename_watchlist

Rename a custom column on a watchlist, or one of its funnel options. **This is how you rename an option in a select/funnel column.** Pass the column in `column`, the option's current label in `option`, and its new label in `new_name`. The option keeps its identity, so every org that had it selected keeps that value and simply shows the new label. Do NOT rename an option by removing it and adding a replacement — that looks equivalent and isn't. Removing an option destroys the cells that used it, and the replacement is created fresh, so those values do not come back. `renamed` reports whether the column or an option changed; for an option, `previous_option`, `option` and the column's resulting `options` — in the shape `get_watchlist_contents` reports them — come back too. Without `option`, the column itself is renamed (only columns you added).

rename_watchlist_column

Find a population of companies matching criteria described in natural language. Industry, market, and technology concepts are matched as keyterms; the attributes below become structured filters. Returns filtered (not ranked) results, so ranking asks such as "top 10 by revenue" come back unsorted — sort them yourself if order matters. Use it for discovery: "AI drug discovery startups in Boston that raised a Series B", "companies acquired by Walmart in logistics", "B2B SaaS companies with 20%+ headcount growth". Do NOT use it to look up or verify one specific named company, or to check attributes of a list of named companies ("Klarna", "AWS ProServe", "company named Evergrow", "are X, Y and Z based in India") — those are rejected; use `get_company_profile` or another `get_company_*` tool. Naming a company as a criterion is fine ("backed by Sequoia", "acquired by Walmart"). For competitors of a named company prefer `get_company_competitors`; company search can be used but is weaker for large multi-segment companies (Apple, ExxonMobil). Available filter attributes (mention any of these in `query` and they are applied automatically, as inclusions or exclusions): geography (headquarters), business model (B2B, B2C, B2G, SaaS, marketplace, freemium, usage-based, etc. — only when the query names one explicitly), company status, commercial maturity, headcount, headcount growth 6m, headcount growth 12m, headcount growth 24m, revenue, revenue growth latest, revenue growth future, revenue multiple, revenue per headcount, stock price, market cap, mosaic overall, mosaic momentum, mosaic money, mosaic market, mosaic management, M&A probability, IPO probability, founded year, total funding, latest funding amount, latest valuation, deal size, exit valuation, historical investment stages, funding round, funding date, deal date, exit date, funding window, VC backed, analyst rating, exit type, investor, lead investor, acquirer, company name. Guidance: REPORTING RESULTS TO THE USER — read before writing any summary: The rendered result view already gives the user full, independent access to every matched company (all `total_results` of them), with their own pagination — this is not limited by how many rows you retrieved into this conversation. Never describe your own retrieval as if it were the user's view. Do NOT say "showing the first 50" or "pulled 50 companies" — the user isn't limited to 50 of anything; they can browse the entire matched set themselves right now. - State `total_results` as the headline number: "matched 5,488 companies" — full stop, that's what the user has. - If you personally read some rows into your own context to reason, summarize, or answer a follow-up question, describe that as your own review, separate from what the user can see — e.g. "I looked at a sample of these to summarize common themes" or "I reviewed 150 of the 2,971 matches to answer your ranking question." Never phrase your own retrieval count as if it were the size or limit of the result set itself. - If total_results is large and the user's request implies judgment/ranking over the whole set (e.g. "who's the best X", "find the top candidate for Y", "which of these is most Z") rather than a structured filter: don't answer from just your first tool call's rows. Page through more of the result set in batches using `paginate_and_sort_search`, scoring/filtering each batch against the user's rubric yourself, keeping only the survivors. State explicitly how many rows you personally evaluated (e.g. "evaluated 300 of 2,971 matches") — as a description of your own analysis depth, never as a description of what the user has access to. Caveats: - Results may include some off-target companies — that is the nature of search over keyterm matching. Review the returned companies and drop rows that don't fit the intent before presenting them. Or run post processing logic to further filter or validate the list against additional custom filters. - Geography is headquarters location only. There is no filter for operations, presence, expansion into, or adoption of something in a place, so such criteria go unsearched. - Highly specific criteria — niche sub-sectors, several stacked quantitative constraints, obscure investor portfolios — can return very few or zero companies. When results are thin, drop or loosen the narrowest criteria, or split the query, instead of stacking more. - Criteria are AND-combined. Genuinely alternative conditions ("funded OR acquired by X", "raised in the last 90 days OR grew headcount 20%+") need one search each. - Prefer several narrow searches over one sprawling multi-sector search. - `analyst_note` is only the headline of the CB Insights analysts' note, not the full note. Attribute it to the analysts and quote it verbatim; never present it as your own view. When the user asks why a company is rated as it is, or wants its thesis, signals, or outlook, and `get_company_analyst_ratings` is available, call it for those companies instead of answering from the headline. If it is not available, say only the headline is available rather than inferring the rest. Always show the citation source URL in your answer - the results must be cited.

search_companies

Find funding deals (financing rounds and investments) matching criteria described in natural language. Industry, market, and technology concepts are matched as keyterms; the attributes below become structured filters. Each result is a deal: the company that raised, the round, amount, date, and participating investors. Results are filtered, not ranked. Use `search_companies` to get companies rather than individual rounds, `search_investors` for a list of firms, and `search_partnerships` for non-financing deals (licensing, partnerships, supply agreements). `search_companies` is also more effective in seeing which companies a particular company invested in or acquired. Available filter attributes (mention any of these in `query` and they are applied automatically): geography, deal size, deal date, investment stage (funding round), investor, lead investor. Caveats: - Geography is the raising company's headquarters; there is no filter for where it operates. - Anything outside the attribute list above (deal rationale, use of proceeds, valuation multiples) cannot be filtered on and goes unsearched. - Highly specific criteria (a niche sub-sector plus a narrow date window plus a specific investor) can return very few or zero deals. When results are thin, loosen or drop the narrowest criteria rather than adding more. Always show the citation source URL in your answer — the results must be cited.

search_deals

Find a population of investors — venture capital firms (VCs), private equity funds (PE), angel investors, family offices, corporate venture arms, hedge funds — matching criteria described in natural language. Portfolio-company industry, market, and technology concepts are matched as keyterms; the attributes below become structured filters. Each result is an investor with their type, location, and investment activity. Results are filtered, not ranked. Use `search_companies` to find the portfolio companies themselves, `search_deals` for individual financing rounds, and `get_company_investors` / `get_company_profile` to look up one named firm rather than discovering a set. A query that is just a firm's name, or a list of named firms to check facts against, is rejected — name investors only as criteria ("co-investors with Sequoia"). Available filter attributes (mention any of these in `query` and they are applied automatically): investor name, investor geography, investor type, investor founded year, investment stage, total funding, deal size, valuation, deal date, co-investor, deals last 12 months, total deals, exit valuation, exits last 12 months, portfolio company name, portfolio company status, portfolio company founded year, portfolio company location. Caveats: - Geography is headquarters location only; there is no filter for where a firm operates or is expanding. - Highly specific criteria (narrow sub-sectors plus several stacked constraints) can return very few or zero investors. When results are thin, loosen or drop the narrowest criteria. Always show the citation source URL in your answer — the results must be cited.

search_investors

Find existing business relationships between companies — partnerships, alliances, collaborations, vendor/client arrangements, licensing, supply/distribution, sponsorships — matching criteria described in natural language. Results are filtered, not ranked. Use it for: partnerships between two industries, cross-sector collaborations, vendor relationships in a market, licensing deals, supply chain connections, sponsorships, strategic alliances. Named companies are expected here as the partner sides. Use `get_company_relationships` for every business connection of one named company without criteria, `search_deals` for financing rounds, and `search_companies` for hypothetical partners ("companies that could partner with X") — this tool only returns relationships that already exist. Relationship-level filters: relationship type (partnership, vendor/client, licensor/licensee, supplier/distributor, sponsorship), relationship keywords, time period, and one or two specific companies or described company populations as the partner sides. When a partner side is described rather than named, it supports the full company filter set (mention any of these in `query` and they are applied automatically): geography (headquarters), business model (B2B, B2C, B2G, SaaS, marketplace, etc. — only when named explicitly), company status, commercial maturity, headcount, headcount growth 6m, headcount growth 12m, headcount growth 24m, revenue, revenue growth latest, revenue growth future, revenue multiple, revenue per headcount, stock price, market cap, mosaic overall, mosaic momentum, mosaic money, mosaic market, mosaic management, M&A probability, IPO probability, founded year, total funding, latest funding amount, latest valuation, deal size, exit valuation, historical investment stages, funding round, funding date, deal date, exit date, funding window, VC backed, analyst briefing, exit type, investor, lead investor, acquirer, company name. Caveats: - Geography is headquarters location only; there is no filter for where a company operates. - Relationship coverage is sparser than company coverage: a specific relationship type plus a niche sector on both sides plus a short time window often returns very few or zero rows. When results are thin, widen the time period, drop the relationship type, or describe only one side. Always show the citation source URL in your answer — the results must be cited.

search_partnerships

Find people (executives, founders, engineers, etc.) by their role and background. Filters are extracted automatically from the natural-language query. Results are filtered, not ranked. Use it when the answer should be a list of PEOPLE ("Heads of Marketing at AI startups", "ex-Salesforce executives now at seed-stage companies"). Use `search_companies` when the answer should be COMPANIES, even if selected by their team ("which AI companies have founders from Salesforce"). The search supports four optional, AND-combined sections: - Person Details: name, location (the person's location), contact availability (email / LinkedIn), education degree, and leadership signals (below). - Current Role: job title, seniority level, department, time in current role, plus the company/industry the role is at. - Past Role: the same job attributes (no time-in-role) for a role the person previously held. - Current or Past Role: a role the person holds OR has held. Available leadership signals (career-spanning achievements; mention any in `query`): repeat founder, technical founder, Y Combinator founder, gave an executive interview to CB Insights, top university alum, founder money raised, valuation achieved, revenue achieved, has IPO'd, has M&A'd, has acquired companies, investment stage experience (Series A, B, C, etc.), and early employee at a top private or recently public company. The company/industry side of any role reuses the full company filter set (industry, market, technology, geography, headcount, revenue, funding, status, etc.) — describe the company in natural language. Available company filter attributes (mention any of these in `query` and they are applied automatically): geography (headquarters), business model (B2B, B2C, B2G, SaaS, marketplace, etc. — only when named explicitly), company status, commercial maturity, headcount, headcount growth 6m, headcount growth 12m, headcount growth 24m, revenue, revenue growth latest, revenue growth future, revenue multiple, revenue per headcount, stock price, market cap, mosaic overall, mosaic momentum, mosaic money, mosaic market, mosaic management, M&A probability, IPO probability, founded year, total funding, latest funding amount, latest valuation, deal size, exit valuation, historical investment stages, funding round, funding date, deal date, exit date, funding window, VC backed, analyst briefing, exit type, investor, lead investor, acquirer, company name. Each result is a person with their CB Insights profile URL (``profile_url``), location, contact info, and roles (job title, seniority, tenure, plus a ``company`` object carrying the org's name, ``id_org``, website ``url``, ``logo_url``, and CBI ``profile_url``). Caveats: - Person location and company geography are headquarters/home locations, not where someone operates or is relocating to. - Stacking a narrow job title, a niche company population, and a tight tenure window often returns very few or zero people. When results are thin, loosen the title or drop the narrowest constraint instead of adding more. Always show the citation source URL in your answer — the results must be cited.

search_people

Find CB Insights proprietary research (analyst content) matching a topic and criteria described in natural language. Topics, industries, and keywords are matched as keyterms; the attributes below become structured filters. Results are filtered, not ranked. Use it for analyst research only — for company, deal, or investor data use `search_companies`, `search_deals`, or `search_investors` respectively. Available filter attributes (mention any of these in `query` and they are applied automatically): research topic / keywords, industry, specific organization, research type, publish date. Research types: market maps, research briefs, state of reports, future of reports, competitor analysis, top company lists, big tech reports, buyer perspective reports, investment thesis maps, customer sentiment, webinars, markets. Caveats: - Without an explicit date in the query, results are limited to the last two years. - Research coverage is a finite analyst library: a narrow topic combined with a specific research type, organization, and date window often returns very few or zero reports. When results are thin, broaden the topic or drop the research type rather than adding criteria. Always show the citation source URL in your answer — the results must be cited.

search_research

Set values in a watchlist's custom columns for one or more orgs. Unresolved orgs, orgs that aren't in the watchlist, unknown columns, values that don't fit a column's type, and two keys landing on the same cell are reported in `errors` (with alternates) and don't fail the rest. `set` lists only what was written — trust it over assuming a value survived, since a failure partway through a select column leaves that cell empty.

set_watchlist_cell_values