multi-server tool-use benchmarking with complexity stratification
Evaluates LLM agents across three task complexity tiers (single-server, two-server, three-server) by orchestrating tool discovery, selection, and execution across 28 diverse MCP servers. The framework uses a task execution pipeline that manages persistent MCP server connections via connection pooling, routes tool calls through a schema-aware dispatcher, and measures success via multi-dimensional metrics combining LLM-as-judge scoring with rule-based compliance checks.
Unique: Stratified complexity tiers (1/2/3 servers) with persistent connection pooling and server-specific rate limiting, enabling realistic multi-provider coordination testing. Uses LLM-as-judge combined with rule-based schema compliance metrics rather than simple pass/fail scoring, capturing nuanced planning failures.
vs alternatives: Deeper than single-tool benchmarks (e.g., ToolBench) by measuring cross-server coordination; more realistic than synthetic tool sets by using 28 production MCP servers across biomedical, finance, and academic domains.
persistent mcp server connection pooling with concurrent tool execution
Manages long-lived connections to 28 MCP servers using connection pooling (via ServerManagerPersistent) to avoid subprocess spawn overhead per tool call. Executes tool invocations concurrently with server-specific rate limiting and timeout enforcement, routing calls through a schema-aware dispatcher that validates tool parameters against declared MCP schemas before execution.
Unique: Implements ServerManagerPersistent with subprocess-level connection reuse and per-server rate limiting queues, avoiding the 200-500ms overhead of spawning new processes per tool call. Validates tool schemas before execution using MCP manifest introspection.
vs alternatives: More efficient than naive subprocess spawning (1 process per call) by maintaining persistent connections; more granular than global rate limiting by enforcing per-server quotas independently.
28-server mcp ecosystem with domain-specific tool coverage
Provides a curated ecosystem of 28 MCP servers spanning biomedical (BioMCP, Medical Calculator), location services (Google Maps, National Parks), academic research (Call for Papers, Paper Search, Wikipedia), finance (DEX Paprika, OKX Exchange), technology (Hugging Face, NixOS, OpenAPI Explorer), data science (NASA Data, Scientific Computing, Weather), and entertainment (Movie Recommender, Game Trends, Reddit). Each server is pre-configured with tool schemas, rate limits, and authentication, enabling agents to discover and use domain-specific tools.
Unique: Curated 28-server ecosystem spanning 8 domains (biomedical, location, academic, finance, technology, data science, entertainment, and more) with pre-configured authentication and rate limits. Enables realistic multi-domain tool coordination testing.
vs alternatives: More comprehensive than synthetic tool sets by using production APIs; more diverse than single-domain benchmarks by covering biomedical, finance, academic, and entertainment tools simultaneously.
agent planning and reasoning with multi-turn tool coordination
Implements agent reasoning loops that discover available tools, plan tool sequences to achieve task goals, execute tools, observe results, and adapt plans based on outcomes. Agents maintain conversation history with the LLM, enabling multi-turn reasoning where each tool result informs subsequent planning steps. The executor (agent/executor.py) orchestrates these loops, managing tool invocations, error handling, and termination conditions (max steps, task completion).
Unique: Multi-turn reasoning loops with conversation history, enabling agents to adapt plans based on tool results. Executor orchestrates tool invocation, error handling, and termination, supporting complex workflows across multiple servers.
vs alternatives: More sophisticated than single-turn tool calling by supporting adaptive planning; more flexible than hardcoded workflows by enabling LLM-driven reasoning.
llm-as-judge multi-dimensional task evaluation with rule-based compliance scoring
Combines LLM-based semantic evaluation (using a judge model to score task completion quality) with rule-based metrics (tool usage patterns, schema compliance, planning effectiveness). The evaluator runs post-execution analysis on agent traces, extracting tool call sequences, measuring planning coherence, and detecting schema violations, then synthesizes scores into a multi-dimensional result set with per-dimension rationale.
Unique: Hybrid evaluation combining LLM semantic judgment with deterministic rule-based compliance checks, avoiding pure LLM evaluation variance while capturing nuanced planning quality. Extracts planning coherence metrics from tool call sequences using graph-based analysis of tool dependencies.
vs alternatives: More nuanced than binary success/failure metrics; more reliable than pure LLM-as-judge by grounding scores in verifiable schema compliance and tool usage patterns.
multi-llm provider abstraction with unified agent interface
Abstracts LLM provider differences (Azure OpenAI, OpenRouter, OpenAI-compatible) behind a unified LLMFactory that returns provider-agnostic Agent instances. Agents use a consistent message-passing interface for tool discovery, planning, and execution, with provider-specific details (API endpoints, authentication, model names) isolated in configuration. Supports streaming and non-streaming modes, automatic retry with exponential backoff, and token counting for cost tracking.
Unique: LLMFactory pattern with provider-agnostic Agent interface, isolating authentication and endpoint details in configuration. Implements unified token counting and cost tracking across providers, enabling fair economic comparison.
vs alternatives: More flexible than provider-specific SDKs by supporting multiple providers with identical agent code; more transparent than black-box LLM APIs by exposing token usage and costs.
task-driven benchmark execution with result persistence and reporting
Orchestrates end-to-end benchmark runs via BenchmarkRunner, which loads task definitions from YAML, spawns agent instances per task, collects execution traces and evaluation results, and persists results to structured JSON output. Supports batch execution with configurable parallelism, task filtering by complexity tier, and result aggregation with statistical summaries (mean/median/stddev across tasks).
Unique: BenchmarkRunner with task-driven YAML configuration, parallel execution with per-server rate limit awareness, and multi-dimensional result aggregation. Persists full execution traces enabling post-hoc failure analysis and reproducibility.
vs alternatives: More structured than ad-hoc evaluation scripts by enforcing task definitions and result schemas; more scalable than sequential execution by respecting MCP server concurrency limits.
tool schema discovery and validation with mcp manifest introspection
Discovers available tools by introspecting MCP server manifests (from mcp_servers/commands.json), extracting tool names, parameter schemas, descriptions, and required fields. Validates tool invocations against schemas before execution, detecting missing required parameters, type mismatches, and enum violations. Exposes tool metadata to agents via a unified schema registry, enabling agents to reason about tool capabilities and constraints.
Unique: Introspects MCP manifests to build a unified schema registry across 28 servers, enabling pre-execution validation and agent-facing tool metadata. Validates against JSON Schema before tool execution, catching parameter errors before MCP server invocation.
vs alternatives: More comprehensive than per-server validation by centralizing schema checks; more flexible than hardcoded tool lists by supporting dynamic discovery.
+4 more capabilities