Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Kismetkanceled/geniehelper/llms.txt
Use this file to discover all available pages before exploring further.
Genie Helper uses three MCP (Model Context Protocol) servers to provide the AI agent with 29 specialized tools for data management, LLM inference, and browser automation.
Architecture
MCP servers run as child processes of AnythingLLM and communicate via stdio transport. They auto-boot on AnythingLLM startup via a patched server/utils/boot/index.js → bootMCPServers() call.
Configuration: storage/plugins/anythingllm_mcp_servers.json
Script: scripts/directus-mcp-server.mjs
Provides CRUD operations for Directus collections, user management, file handling, and flow triggering.
Collections
| Tool | Description |
|---|
list-collections | List all custom Directus collections (excludes system tables) |
get-collection-schema | Get field schema for a collection with types and requirements |
Items CRUD
| Tool | Description |
|---|
read-items | Read items with optional filtering, sorting, pagination, and field selection |
read-item | Read a single item by ID (UUID) |
create-item | Create a new item with tier-gating for media_jobs operations |
update-item | Update an existing item by ID |
delete-item | Delete an item from a collection |
search-items | Full-text search across items in a collection |
Users
| Tool | Description |
|---|
get-me | Get the current authenticated user with full profile fields |
list-users | List users with optional filtering (admin operation) |
get-user | Get a single user by ID with role information |
update-user | Update a user by ID (admin operation) |
create-user | Create a new user (requires email, password, role UUID) |
Files
| Tool | Description |
|---|
list-files | List files with optional folder filtering and metadata |
get-file | Get file metadata and download URL by ID |
Flows
| Tool | Description |
|---|
list-flows | List all available Directus Flows with trigger information |
trigger-flow | Trigger a flow by UUID with optional JSON payload |
Tier Gating
The create-item tool includes built-in rate limiting for media_jobs creation:
- Checks feature access flags (
ai_clip_ops, watermark_ops, etc.) against subscription tier
- Enforces usage quotas by counting
user_usage_counts within billing cycle
- Throws
tier_limit: prefixed errors visible to the agent
- Fails open on unexpected errors to maintain availability
Script: scripts/ollama-mcp-server.mjs
Exposes Ollama’s local LLM inference API for text generation, chat, and model management.
| Tool | Description |
|---|
list-models | List all locally available Ollama models with size and modified timestamps |
generate | Single-turn completion with prompt, optional system message, temperature, and max_tokens |
chat | Multi-turn chat using messages array with role/content objects |
Configuration
- Default URL:
http://127.0.0.1:11434
- Default model:
qwen-2.5:latest (configurable via OLLAMA_MODEL env var)
- Temperature range: 0-2 (default 0.7)
- Stream mode: Disabled (all responses are synchronous)
Script: scripts/stagehand-mcp-server.mjs
Wraps the Stagehand browser automation server (port 3002) for web scraping, platform interactions, and HITL (human-in-the-loop) workflows.
Session Management
| Tool | Description |
|---|
start-session | Start a new browser session with configurable headless mode, returns session ID |
close-session | End and clean up a browser session |
Navigation & Interaction
| Tool | Description |
|---|
navigate | Navigate to a URL in an existing session |
act | Perform browser actions using natural language (“Click the Login button”) |
observe | Observe interactive elements on the current page |
| Tool | Description |
|---|
extract | Extract structured data using natural language instruction and optional JSON schema |
screenshot | Take a screenshot of the current browser page (returns base64 or URL) |
Cookie Management
| Tool | Description |
|---|
get-cookies | Get all cookies from the current browser session |
set-cookies | Inject cookies for bypassing login (HITL workflow) |
Configuration
- Stagehand URL:
http://127.0.0.1:3002
- Default model:
ollama/qwen-2.5 (for vision/element detection)
- Launch args: Stealth mode enabled (
--disable-blink-features=AutomationControlled)
- Window size: 1920x1080
- Resource limits: ~300MB RAM per active session, ~33 concurrent sessions ceiling
Error Handling
All tools surface HTTP errors to the agent with status code and error message extraction from Stagehand responses.
platform_sessions: Stores encrypted browser cookies captured via extension or HITLhitl_sessions: Human-in-the-loop login requests (triggers yellow dashboard alert)media_jobs: BullMQ job records for scrape, watermark, teaser, publish operationsaction_flows: Flow definitions consumed by Action Runner (slug → steps JSON)
See Also
