Tools reference
Tools are the assistant's hands. Each is a function the model can call with structured arguments; results stream into the chat and, for creation tools, onto the board. This page lists all of them.
Legend. read-only tools are available in Plan mode. PRO tools need a Pro or Enterprise-Pro license. Needs lists any account or key the tool depends on; everything else works with no configuration.
Tools are grouped into tiers. With Smart tool loading off (the default) every tier you are entitled to is available immediately; with it on, the assistant starts with core and loads others on demand.
Core
Always available.
| Tool | What it does |
|---|---|
search_board read-only | Full-text search of the board's nodes, actors, organizations and narratives. The assistant is instructed to call this before creating anything, to avoid duplicates. Omit the query to browse everything. |
read_node read-only | Read a node's complete content when the search result was truncated. |
get_board_diff read-only | Everything created or modified in a time window ("1h ago", "since yesterday", ISO dates). Useful after a collaborator's sync or a feed poll. |
create_note | Create Note nodes. |
create_connection | Create typed connections (all eleven types), directed or two-way, with reasoning. |
update_node | Update a node by ID or name. Content is merged, not replaced. |
delete_node | Delete a node (duplicates, errors, merges). |
delete_connection | Delete a connection by ID or by source/target names. |
get_cached_result read-only | Retrieve a large earlier tool result that was truncated in the chat. |
review_chat_images read-only | Look again at images you sent in the conversation before describing or saving them. |
ask_user | Ask you a multiple-choice question and wait for the answer. |
get_more_tools | Load another tier (only when Smart tool loading is on). |
Entities
| Tool | What it does |
|---|---|
create_actor | Create actors (people, handles, sources, journalists, outlets). Placed on the board as nodes; Wikipedia enrichment runs afterwards. |
create_organization | Create organizations. Same behaviour. |
create_event | Create Events with dates, significance and real source URLs. |
create_location | Create Locations with coordinates. |
create_prediction | Create Predictions with reasoning and a timeframe. |
All entity tools accept a batch (an array) so the assistant can create ten actors in one call.
Research
| Tool | What it does | Needs |
|---|---|---|
web_search read-only | Web search. Uses Exa when a key is configured, otherwise DuckDuckGo through a hidden browser. topic: news, time range, and deep: true to extract full text from the top three results. Safe search on by default. | Exa key optional |
search_wikipedia read-only | Wikipedia article summaries. | — |
scrape_url read-only | Extract the readable article from a URL (same extractor as News Article nodes, with archive fallback for paywalls). | — |
image_search read-only | Find images to use with create_media. Safe search on by default. | — |
geocode_address read-only | Address → coordinates and back (OpenStreetMap Nominatim). | — |
route_directions read-only | Driving / walking / cycling route between two points with distance, duration and turns (OSRM). | — |
map_snapshot read-only | Render a map image with markers and/or a route and return it to the model so it can see the geography. | — |
search_nearby read-only | Points of interest around a location by category or name (OpenStreetMap Overpass). | — |
youtube_transcript read-only PRO | Transcript of a video (watch, shorts, live, youtu.be URLs). Long transcripts are summarized, optionally around a focus. | — |
youtube_channel_videos read-only PRO | Recent videos from a channel by @handle, URL or channel ID. | — |
youtube_comments read-only PRO | Top-level comments with authors, likes and times. | — |
person_search read-only PRO | US public-records people search (ZabaSearch): name, city, state, age. | — |
person_details read-only PRO | Full record for a person_search result. | — |
search_court_cases read-only | US court records via CourtListener: federal PACER dockets and state case law. | CourtListener token |
get_court_case_details read-only | Parties, attorneys and docket entries for a case. | CourtListener token |
search_judges read-only | US judges: biography, appointments, affiliations. | CourtListener token |
search_github read-only | GitHub users, repositories and code - for technical profiling. | GitHub token optional (raises rate limit) |
username_search read-only | Check a username across ~480 sites (a port of Sherlock). | — |
list_username_sites read-only | List the sites username_search covers. | — |
wayback_lookup read-only | Does the Wayback Machine have this URL, and when? | — |
wayback_fetch read-only | Read an archived copy of a page. | — |
whois_lookup read-only | Domain registration via RDAP: registrar, dates, nameservers. | — |
search_sanctions read-only | OFAC SDN and the US Consolidated Screening List. | — |
search_sec_filings read-only | Full-text search of SEC EDGAR filings with form and date filters. | — |
get_company_filings read-only | Company profile and recent filings by ticker or CIK. | — |
get_company_financials read-only | Structured annual financials and ratios from XBRL. | — |
get_sec_filing_content read-only | Clean text of a filing document; long ones summarized. | — |
Social
| Tool | What it does | Needs |
|---|---|---|
social_search read-only | Search Reddit, X/Twitter, Bluesky and YouTube; can also fetch a post by URL. | X search needs a connected X account |
fetch_social_post read-only | Fetch one post by URL (X, Reddit, Bluesky). | — |
create_social | Create a Social Post node from a URL; everything is fetched. | — |
search_social_users read-only | Find people on X or Bluesky by name or handle. | Connected account |
get_user_timeline read-only | Recent posts by a user. | Connected account (X) |
get_user_profile read-only | Profile for an X, Bluesky or YouTube user. | — |
Which platforms work anonymously is detailed in Social media.
Media
| Tool | What it does |
|---|---|
create_media | Media node from an image/video URL, or from an image you attached to the chat. |
create_embed | Embed node for a link with preview (X, YouTube, Reddit, any page). |
create_document | Document reference node. The assistant cannot attach the file; you do that in the editor. |
create_newsfeed | News Article node from a URL (scraped in the background). |
fetch_and_create_newsfeed | Scrape now, summarize, then create the node - the assistant's preferred way to file an article. |
create_rssfeed PRO | Subscribe to an RSS feed or a social account as a feed. |
Narratives
| Tool | What it does |
|---|---|
create_narrative | Create storylines. |
add_to_narrative | Add nodes (by ID or name) to a narrative with a relevance level. |
create_narrative_link | Link two narratives (supports, contradicts, parent/child, …). |
search_narratives read-only | Find existing narratives. |
update_narrative | Replace description, summary, status, themes. |
delete_narrative | Delete a narrative; members are unlinked, not deleted. |
Newspapers PRO
| Tool | What it does |
|---|---|
search_newspapers read-only | Historic American newspapers 1777-1963 (Library of Congress Chronicling America), returning OCR excerpts. |
read_newspaper_page read-only | Full OCR text of a page from those results. |
Custom PRO
Your own tools, written in JavaScript and dropped into the custom-tools folder. They appear here under whatever names you give them. See Custom tools.
Notes on sources
- No API keys are ever sent anywhere but the service they belong to. Exa, CourtListener and GitHub keys go to those services; the assistant never sees the key values.
- Public-records and people-search tools return whatever the public source returns. Treat results as leads, not facts, and record verification on the node.
- Sources that block automated access will fail from time to time; the tool reports the failure and the assistant tries another route or asks you.
- Rate limits: Nominatim is limited to one request per second; GitHub to 60 requests/hour without a token; SEC EDGAR asks for a descriptive user agent, which DeepState sends.