Connection check
verified live · 20h ago
signals-4
Millions of dated buying and momentum signals: who raised, who's hiring, what changed and when
Tools
10
GitHub stars
—
Installs / wk
—
Licence
—
Transport
streamable-http
Last checked
20h ago
Tools & capabilities
10 toolsRead from the running server on 20h ago.
check_watches
read-only
limitdomaininclude_acknowledged
Returns what has happened at the companies THIS KEY ALREADY WATCHES, since the last time you asked. This is a personal inbox, not a view of the index. Use it when the question is… Returns what has happened at the companies THIS KEY ALREADY WATCHES, since the last time you asked. This is a personal inbox, not a view of the index. Use it when the question is about continuity — "anything new since last time", "what did I miss", "what fired on my watchlist". If the question is what is happening at companies generally — latest signals, who raised, who is hiring, anything about the market or a company not already watched — that is search_signals, and this tool cannot answer it. Do not open a session with this call. Answer what was actually asked first; reach for this when the user's question is about their own watches. Each event is handed over once: collecting it marks it seen, so the next call returns only what is new. Pass include_acknowledged to re-read ones you already collected. An empty result means nothing matched YOUR watches. It is not a statement about the market, and if you hold no watches it says nothing at all — the response reports how many you have so the two cases can be told apart. The response also lists your active watches, so this is the only call needed to see both what fired and what is armed. Cost: free — call it as often as you need.
find_company
read-only
name*limitcountry
Finds a company in the BounceWatch index by name, and returns its domain — which is what every other company tool needs. Use this whenever you have a company's NAME rather than it… Finds a company in the BounceWatch index by name, and returns its domain — which is what every other company tool needs. Use this whenever you have a company's NAME rather than its domain. Do not guess the domain: a wrong guess comes back as "not indexed" for a company we actually hold, and sends you on to spend a scan on a domain nobody checked. Returns up to a handful of candidates with just enough to tell them apart — country, founding year, headcount, and when we last saw a signal. It never picks for you: names are ambiguous and you have the context that decides. If several look plausible, say so rather than choosing silently. Once you have picked, get_company returns the full profile. An empty result means no company by that name is in our index. It is not a statement about whether the company exists. If you know its domain, refresh_company indexes it. Cost: 3 credits per call. Failed calls are not charged.
get_company
read-only
domain*include
Firmographic profile of one company from the BounceWatch index: identity, location, headcount, funding history, tech stack, team and competitors. Returns what we currently hold —… Firmographic profile of one company from the BounceWatch index: identity, location, headcount, funding history, tech stack, team and competitors. Returns what we currently hold — it never triggers a scan on its own. `coverage` says what monitoring this company is under; if it is not being followed continuously and the answer depends on facts being current, call refresh_company explicitly. For what has been HAPPENING at a company rather than what it IS, use get_company_signals. Cost: 10 credits per call at minimum, rising with the extra data you request. Failed calls are not charged.
get_company_signals
read-only
dayslimitdomain*categoriessignal_keys
Returns the dated signal timeline for one company: funding, hiring, partnerships, expansion, product launches, leadership changes and risk events. Use this when you already know w… Returns the dated signal timeline for one company: funding, hiring, partnerships, expansion, product launches, leadership changes and risk events. Use this when you already know which company you care about and need to know what has been happening and when. To find companies by signal instead, use search_signals. categories and signal_keys widen each other rather than narrowing to the overlap: a category adds all of its keys to whatever signal_keys already lists. Read `coverage` before drawing conclusions. If `coverage.signal_absence_is_meaningful` is false, an empty or thin result reflects our scanning gap, not the company — say so rather than reporting the company as quiet. Cost: 8 credits per call. Failed calls are not charged.
get_refresh_status
read-only
batch_id*wait_seconds
Checks a scan queued by refresh_company, and WAITS for it. This call blocks until the scan is done or `wait_seconds` runs out, so you do not have to idle between polls — just call… Checks a scan queued by refresh_company, and WAITS for it. This call blocks until the scan is done or `wait_seconds` runs out, so you do not have to idle between polls — just call it again if it comes back unfinished. A typical scan needs two or three calls at the default wait. Read `is_finished`, not `status`. A scan reaches `completed` when its jobs report back, but the signal analysis they started is still writing rows for a few seconds after that — read too early and you get the pre-scan picture with a completed stamp on it. `status` becomes `settling` for that window and `is_finished` stays false until the writes stop. Do not answer from the old data while a scan you asked for is unfinished: you requested it because the existing figures were too stale to rely on, and they have not changed yet. Either wait for it, or say plainly that a refresh is in flight. When it finishes, `signals_added` says how many new signals the scan actually produced — zero is a real answer and means we looked and found nothing new, not that the scan failed. Then read the data with get_company or get_company_signals; this tool returns progress, not company data. Cost: free — call it as often as you need.
get_signal_taxonomy
read-only
Lists every signal type BounceWatch detects, grouped by category, with what each one means and whether it is an announcement or an unconfirmed inference. It also returns `coverage… Lists every signal type BounceWatch detects, grouped by category, with what each one means and whether it is an announcement or an unconfirmed inference. It also returns `coverage`, which says which categories produce steadily and which are rare by nature. Read it before designing a search: the rarest signals are the highest-value ones — funding, acquisitions, shutdowns — and searching a window for them usually returns almost nothing, because that is how often they happen. Those are caught with watch_company, not with a query. Call this before filtering by signal type in search_signals or get_company_signals: filters are matched exactly, and an unrecognised key returns nothing rather than an error. The answer is stable, so once per session is enough. Cost: free — call it as often as you need.
refresh_company
domain*modules
Queues a fresh scan of one company and returns a batch id to poll with get_refresh_status. Works for companies already in the index and for domains we have never seen, which is how… Queues a fresh scan of one company and returns a batch id to poll with get_refresh_status. Works for companies already in the index and for domains we have never seen, which is how you add one. A scan only refreshes what you ask for, and each module reads a different source. Anything you leave out keeps the date it already had, so pick by the fact you need: signals recent events and announcements (default) funding rounds, investors, valuations (default) team headcount, leadership, open roles technology tech stack business positioning, model, target market competitors similar companies The default is signals + funding, because those are the two that go out of date fastest and the two most answers turn on. Pass modules explicitly to go cheaper — `["signals"]` alone is the least you can usefully scan. This spends credits and real scanning budget, so call it deliberately: when `coverage` on a previous answer showed stale data AND the decision depends on current facts. Do not call it speculatively across a list of candidates. Returns in a second or two; the scan itself typically takes 60-180 seconds. Poll get_refresh_status (free) until it reports finished, then re-read the data with get_company or get_company_signals. Cost: 36 credits per call at minimum, rising with the extra data you request. Failed calls are not charged.
search_companies
read-only
limitcountryfounded_afterfunding_stagemax_employeesmin_employees
+2
Finds companies by firmographics — country, headcount, funding stage — within the set BounceWatch actively observes, most recently refreshed first. By default it returns only comp… Finds companies by firmographics — country, headcount, funding stage — within the set BounceWatch actively observes, most recently refreshed first. By default it returns only companies we have observed in the last 90 days, so the firmographics you get are backed by recent observation rather than a record we last touched years ago. Each result reports its signal activity, so you can tell a closely-watched company from a thinly-covered one. If you want companies selected by what HAPPENED to them rather than by what they ARE — recently funded, hiring, expanding — use search_signals instead. That is the stronger discovery path and usually the one you want. Cost: 5 credits per call. Failed calls are not charged.
search_signals
read-only
dayssortlimitcountrycategoriesmin_weight
+7
The latest signals across the whole index: which companies did something recently, what it was, and when. This is the tool for ANY question about what is happening. "Show me the l… The latest signals across the whole index: which companies did something recently, what it was, and when. This is the tool for ANY question about what is happening. "Show me the latest signals", "what's new", "which companies raised a round and are now hiring sales in the Netherlands", "who announced expansion in the last two weeks", "which of my target segment just made a key hire". Returns matching companies with the signals that matched and their dates. Reach for this first. check_watches only reports on companies already being watched by this key and cannot answer a question about the market or about a company that is not on that list. Filter by signal type, category, recency, country, headcount and funding stage. Call get_signal_taxonomy first if you are unsure which signal keys exist — unrecognised keys are rejected rather than quietly returning nothing. The two signal filters WIDEN each other rather than narrowing to the overlap: a category adds all of its keys to whatever signal_keys already lists. min_weight then cuts what is left, so a low-weight signal type named alongside a floor above its own weight returns nothing rather than one of the two being quietly ignored. `coverage` is working material for you, not for the answer: it bounds what this search could have found. Let it shape what you claim, and offer a narrower search rather than reporting figures about our index. Cost: 12 credits per call. Failed calls are not charged.
watch_company
stoplabeldomain*min_weightsignal_keysdeliver_webhook