MCP server for searching the B&R Automation community forum
Server has 5 well-named, read-only tools with clear descriptions (avg 85 chars). All tools have documented input schemas with types and descriptions. However, output schemas are inferred from Python type hints rather than explicitly documented in descriptions. Parameter descriptions are present but lack constraint details (enums, ranges, formats). No error handling guidance or recovery paths documented. Missing tool annotations (readOnlyHint present implicitly via risk:READ_ONLY, but not in schema). Naming follows verb_noun pattern well (search_*, get_*, list_). No security issues detected (read-only, no secrets). Composition is sound, tools chain logically (search → get_topic, list_categories → get_latest_topics).
Get the latest topics from the B&R Community forum.
Get the top/most popular topics from the B&R Community forum.
Get detailed information about a specific topic including its posts.
List all available categories in the B&R Community forum.
Search the B&R Community forum for topics and posts.
Output schemas not documented in tool descriptions. Python type hints (SearchResults, TopicDetails, CategoryList) exist but LLMs cannot inspect them. Descriptions should state: 'Returns a SearchResults object with fields: query (str), total_posts (int), posts (list of SearchResultPost with id, topic_id, username, created_at, blurb, topic_title, url, like_count).'
Parameter descriptions lack constraint details. 'period' in get_top_topics lists valid values ('daily', 'weekly', etc.) in description but should use enum constraint in schema. 'max_posts' lacks range (1 - 100?). 'page' lacks bounds. Enums and ranges prevent LLM hallucination.
No error handling guidance. If search_community returns 0 results, or get_topic fails with 404, descriptions do not tell LLM what to do next (retry, try different query, list_categories first?). Missing recovery paths.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | 2026-07-28+ | v2 |
Tool annotations missing from schema. All tools are read-only (no side effects), but schema does not include readOnlyHint:true. This forces LLMs to infer safety from descriptions rather than machine-readable hints.
Pagination not fully documented. get_latest_topics and get_top_topics accept 'page' but descriptions do not state: page size, total count returned, or how to detect end of results. LLMs cannot reliably paginate without explicit guidance.