Knowledge, Web & File Tools
These tools let the assistant pull outside knowledge into your conversation — reading local documents, converting web pages to Markdown, or searching community forums.
Reading local files and web pages
| Tool | What it does |
|---|---|
file2md | Converts a local file (PDF, DOCX, XLSX, PPTX, HTML, CSV, JSON, XML, TXT, EML, EPUB, RTF, and more) into clean Markdown text. |
web2md | Fetches a web page URL and converts it to Markdown. Includes dedicated extractors for Wikipedia/Wikimedia, GitHub/GitLab files, Discourse forum posts, and Stack Exchange questions, with a clean HTML-to-Markdown fallback for general pages. Respects robots.txt. |
Searching and reading community forums
SmartHopper provides three sets of forum tools — one for the McNeel Discourse forum (mcneel_*), one for the Ladybug Tools forum (ladybug_*), and one for any Discourse forum (discourse_*, where you pass the forum's base_url):
| Tool pattern | What it does |
|---|---|
mcneel_forum_searchladybug_forum_searchdiscourse_forum_search | Searches forum posts and topics by keywords and returns matching results. |
mcneel_forum_post_getladybug_forum_post_getdiscourse_forum_post_get | Fetches a single forum post by its numeric ID (author, date, title, and Markdown content). |
mcneel_forum_topic_getladybug_forum_topic_getdiscourse_forum_topic_get | Fetches all posts in a forum topic (thread) by topic ID, with an optional max_posts cap. |
mcneel_forum_post_summarizeladybug_forum_post_summarizediscourse_forum_post_summarize | Generates a concise AI summary of one or more forum posts by ID, optionally focused on specific instructions. |
mcneel_forum_topic_summarizeladybug_forum_topic_summarizediscourse_forum_topic_summarize | Generates a concise AI summary of an entire forum topic by ID. |
Search first, then read selectively
Full forum threads can be long. Searching first and fetching or summarizing only the relevant posts keeps responses fast and avoids unnecessary token usage.