Research backend and tool interface for AI agents with multi-source web research, credit-based billing, and MCP server support
Single tool 'veritas_research' has a reasonable name and description, but critical gaps in schema documentation and parameter descriptions. The input schema is visible with three parameters (query, mode, sessionId), but parameter descriptions are minimal or missing context. Mode enum is present but lacks explanation of what 'lite', 'medium', 'deep' actually do in terms of research scope, cost, or latency. SessionId is marked optional but its purpose and lifecycle are unexplained. No output schema is documented, LLMs cannot plan downstream actions or extract structured results. Error handling and recovery guidance are absent. The tool lacks idempotency guarantees, timeout specifications, and rate-limit guidance critical for agent reliability.
Run trusted multi-source web research. Use this when an agent needs current facts, source checks, or structured research output.
No output schema documented. LLMs cannot infer what fields the response contains, breaking downstream tool chaining and forcing agents to guess at result structure.
Parameter 'mode' enum values (lite, medium, deep) lack descriptions. LLMs cannot determine which mode to select without understanding research depth, cost, or latency tradeoffs.
Parameter 'sessionId' marked optional but its purpose, lifecycle, and when to reuse it are unexplained. Agents cannot determine whether to generate new IDs or reuse prior ones.
No error handling guidance. Tool description does not explain failure modes (network timeout, no results found, rate limit hit) or recovery steps.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2025-06-18+ | v2 |
Tool description does not specify idempotency, timeout, or rate-limit behavior. Agents cannot safely retry or batch calls without risking duplicate research or service overload.