Tool Design & MCP Integration

CCAR-F · 36 questions

• A 311 MCP suite exposes lookupcase and getticket with near-identical one-line descriptions, so Claude misroutes calls. What should architects fix first?
• A permits MCP search tool description omits input formats and edge cases, so Claude often picks the wrong search tool. What should the description include?
• A public-health portal has a vague analyzecontent tool that overlaps lab extraction. What redesign best reduces selection errors?
• A housing authority agent relies on one generic analyzedocument tool for extraction, summary, and claim checks. What interface change helps most?
• A transit system prompt says "always search" and overrides careful MCP tool descriptions. What should architects review?
• A court clerk MCP set uses minimal one-word descriptions across similar filing tools. Why does selection stay unreliable?
• A water-billing MCP exposes accountlookup and meterreadhistory. What should each description clarify?
• A parks reservations MCP often confuses group versus individual bookings. What description content reduces ambiguous selection?
• A permitting MCP returns only "Operation failed" with no metadata, so the agent cannot decide retry versus explain. What should errors include?
• A 311 validation error should not be retried in a loop. How should the tool mark it?
• A housing search subagent hits a transient timeout on one source. What error-handling pattern should it follow?
• A utility MCP must distinguish empty meter history from access denial. Which design is correct?
• A court e-filing MCP call fails because the clerk role lacks write rights. How should the tool respond?
• A health MCP source times out mid-fetch after some lab rows arrive. What should the structured error carry?
• A transit fare tool rejects a policy-violating adjustment. How should structured errors steer the agent?
• A solid-waste MCP returns the same generic failure string for every problem. Why is that harmful?
• A synthesis-only civic research agent is given 18 tools including web search and starts mis-calling search. What distribution fix is best?
• A municipal report-writer subagent keeps calling web search instead of synthesizing provided findings. What tool-set change helps?
• A parcel enrichment coordinator must run extractparcelmetadata before any enrichment tools. How can it enforce that first call?
• A clerk extraction workflow must produce a schema tool call rather than free-form chat. Which toolchoice setting fits?
• A housing agent previously used unconstrained fetchurl for policy PDFs. What safer tool design validates civic document sources?
• A civic policy synthesizer often needs quick fact checks but must not get full open-data search rights. What tool-distribution pattern fits?
• A transit ops agent sometimes answers from context and sometimes must call a named MCP tool. What should architects understand about toolchoice?
• A city engineering team wants shared Jira MCP servers for every clone without committing tokens. Where should the MCP config live?
• A developer experiments with a GIS MCP that teammates should not inherit. How should it be configured?
• A permits team finds Claude picking weak Grep guesses instead of the capable MCP search tool. What should they improve?
• County IT needs standard Jira ticket workflows for service desks. What MCP approach fits first?
• A library catalog agent wastes calls exploring collection schemas. How can MCP resources help?
• A transit monorepo configures several MCP servers. What should be true after connection-time discovery?
• Treasury has unique levy calculation workflows no community server covers. When is a custom MCP justified?
• A municipal legacy explorer must find all callers of calculatefee across packages. Which built-in tool fits best?
• A school-district agent must locate test files by name pattern regardless of folder layout. Which tool should it use?
• Edit fails because anchors in a shared utility module are not unique. What should the civic coding agent do?
• A water SCADA helper needs to understand a large legacy tree without loading everything. What built-in strategy fits?
• A court case-management refactor must find usages of wrapper-exported helpers. What search sequence works?
• A parks booking service needs a small, precise change in one handler with unique surrounding text. Which built-in fits?