MCP server providing TRON documentation search (java-tron basics and developer guides) and on-chain blockchain query capabilities (blocks, transactions, accounts)
Single tool with basic but incomplete definition. Tool name uses Search prefix (acceptable) but lacks the specificity patterns recommend. Description is adequate at 139 characters but lacks critical context about when to use this tool vs alternatives, expected response format, and any prerequisites. Input schema is present with proper JSON Schema structure, but the query parameter description is vague (10 chars: 'A query to search the content with.'). No output schema is documented, the perform_search() function returns free-form text concatenation without describing the structure callers should expect. No error handling guidance for LLMs. No parameter constraints (e.g., max query length, minimum word count). The tool performs a read-only operation (good security posture), but lacks idempotence hints and no mechanism for pagination despite returning top-5 results.
Query account information from the TRON blockchain by address. Returns balance, resources (bandwidth/energy), TRC-10 tokens, stake information, votes, and permissions.
Query account resource information from the TRON blockchain. Returns bandwidth, energy, and other resource details.
Query block information from the TRON blockchain by block number (height) or block hash. Returns block details including timestamp, transactions, witness address, etc.
Get the latest block information from the TRON blockchain. Returns the most recent block details.
Query transaction information from the TRON blockchain by transaction hash (ID). Returns transaction details including sender, receiver, amount, timestamp, confirmation status, etc.
Search across the java-tron developer documentation to find how to deploy and interact with a java-tron node, and how to develop DApps based on java-tron.
Parameter description too vague and under minimum guidance length. 'A query to search the content with.' (10 chars) does not explain expected format, example queries, constraints, or when this tool is appropriate vs other documentation lookup methods.
No output schema documented. Function returns free-form text (concatenated markdown-like strings) with no structure hints. LLMs cannot predict field names or format downstream, forcing unstructured text parsing. Baselines show 100% of A+ tools have documented return types.
Tool description lacks context on when to use it. Does not explain: What problem does it solve? When should it be called? What are prerequisites? What does it return? Current description (139 chars) is barely above minimum threshold and reads like an API stub rather than LLM-optimized guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 6 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 42 | 2024-11-05+ | v1 |
Search across the java-tron documentation to find the basic principles of java-tron, and how to deploy a java-tron node and interact with it.
No input validation or error guidance. Code silently returns 'Index not found' or 'No relevant documentation found' but does not tell LLMs what to do next (e.g., 'Try a different query with fewer words' or 'Index must be built with mkdocs build'). Error responses lack actionable recovery paths.
Query parameter lacks constraints (min/max length, character restrictions, word count expectations). Code splits on spaces and requires all words to match, but this behavior is not documented in the parameter description. LLMs will not infer this from the schema alone.
Hardcoded BASE_URL and INDEX_PATH limit flexibility. No way for LLMs to discover available search indexes or change search scope. Discovery tools like 'list_documentation_sections' would enable better tool composition and user intent alignment.
No pagination or result limiting hints. Function caps at 5 results with no offset/limit parameters and no indication of how many total matches exist. If a query matches 500+ docs, truncating to 5 silently loses information. Large result sets should support pagination per pattern:paginated-result baseline.