Tools/Filings & watchlist

watchlist.add

freewrites data

Start watching a company or a fund for THIS workspace, so new SEC filings on it surface later without anyone asking again. Use it the moment a user shows ongoing interest in a name — after a capital_change_brief, an insider lookup, or an explicit 'keep an eye on this'. Watched tickers are what watchlist.poll returns, and they drive the email alerts on the account. Free, no credits. Offer it rather than assuming it.

Parameters#

ParameterTypeDescription
kindreqstring'ticker' to watch a company's insider filings, 'fund' to watch an institution's 13F filingsone of: ticker, fund
refreqstringTicker symbol (e.g. 'MREO') for kind=ticker, or the fund's SEC CIK for kind=fund
labeloptstringOptional display name, e.g. 'Mereo BioPharma'

Example call#

bash
curl -X POST https://arkolith.com/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "watchlist.add",
    "arguments": {
      "kind": "ticker",
      "ref": "example"
    }
  }
}'

Example response#

Shape varies
Output depends on your arguments and live data. Make the call above to see the exact response. Every result includes a provenance block where the source carries one.
Free tool
This call costs 0 credits. Use it freely.

Related tools#

events.latestwatchlist.removewatchlist.listwatchlist.pollwatchlist.poll.live
← Previous
events.latest
Next →
watchlist.remove