An MCP server that manages agentic workflows using LangGraph, supporting flexible agent configurations, conditional branching, parallel execution, orchestrator-worker patterns, and RAG with ChromaDB embeddings.
This server has 18 tools with significant definition quality gaps. While tool names are generally action-oriented (display_, start_, embed_, retrieve_, modify_, read_, write_, append_, list_, run_, web_, validate_, api_), descriptions are present but many lack sufficient depth for LLM decision-making. Schemas are partially visible but lack comprehensive parameter descriptions and type constraints. Several tools expose internal complexity (app_ctx, retrieval_chain as object params) that should be abstracted. The server mixes concerns (embed_files does both embedding AND storage; start_workflow couples user interaction with config loading). Most critically: (1) many parameter descriptions are minimal or missing; (2) no output schemas are documented; (3) no error handling guidance; (4) no pagination support despite tools like list_files returning unbounded results; (5) high-risk tools (run_shell_command, start_workflow, write_file) lack confirmation or dry-run support.
Fetch data from an API endpoint.
Appends the given content to a file. Creates directories if they don't exist.
Appends lines content at the specified line numbers to a file. Creates directories if they don't exist.
Generates a graph image from the workflow configuration and saves it to a file. The graph is generated using the LangGraph library and saved as a PNG image.
Tool to create embeddings for one or more files or folders and store them in the ChromaDB.
Lists all files in a given directory.
Updates the embeddings for the specified files.
Missing output schemas for all tools
Internal implementation details exposed as parameters (app_ctx, retrieval_chain, logs as object params)
High-risk tools (run_shell_command, start_workflow, write_file, write_file_lines) lack confirmation or dry-run pattern
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 58 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 42 | - | v1 |
Reads the content of a file and returns it as a string.
Reads the content of multiple files and returns them as a single string.
Reads the content of multiple files and returns them as a JSON string mapping file IDs to contents.
Answers a question using the Retrieval chain and local ChromaDB vectors.
Execute a shell command and return its output.
Starts a LangGraph workflow to process the user prompt. The workflow is defined in a config file existing in the workspace. The relative path to the config file is defined in the environment variable WORKFLOW_CONFIG_PATH in .env file in the workspace.
Validates an XML file against an XSD schema using xmllint.
Visualize embeddings from a ChromaDB collection using PCA and Plotly.
Performs a web search using DuckDuckGo and returns the results.
Writes the given content to a file. Creates directories if they don't exist.
Write lines content at the specified line numbers to a file. Creates directories if they don't exist.
No enumeration constraints on method parameter (api_fetch) and type parameter (display_graph), invites hallucinated values
List tools (list_files, read_multiple_files) have no pagination support, unbounded results risk context window exhaustion
File/shell tools lack input validation and error guidance (max file size, encoding, timeout, permissions)
Ambiguous parameter types and unions (file_paths in modify_embeddings is [string|array]; lines in write_file_lines is object but semantics unclear)
Descriptions lack recovery guidance, no hints for when to call related tools or how to handle failures
API authentication and credential handling not documented (api_fetch, web_search, start_workflow with config)