Skip to main content

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​

ToolWhat it does
file2mdConverts a local file (PDF, DOCX, XLSX, PPTX, HTML, CSV, JSON, XML, TXT, EML, EPUB, RTF, and more) into clean Markdown text.
web2mdFetches 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 patternWhat it does
mcneel_forum_search
ladybug_forum_search
discourse_forum_search
Searches forum posts and topics by keywords and returns matching results.
mcneel_forum_post_get
ladybug_forum_post_get
discourse_forum_post_get
Fetches a single forum post by its numeric ID (author, date, title, and Markdown content).
mcneel_forum_topic_get
ladybug_forum_topic_get
discourse_forum_topic_get
Fetches all posts in a forum topic (thread) by topic ID, with an optional max_posts cap.
mcneel_forum_post_summarize
ladybug_forum_post_summarize
discourse_forum_post_summarize
Generates a concise AI summary of one or more forum posts by ID, optionally focused on specific instructions.
mcneel_forum_topic_summarize
ladybug_forum_topic_summarize
discourse_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.