A Model Context Protocol (MCP) server for metacontract smart contract development.
Six tools with basic descriptions but significant gaps in schema completeness and parameter documentation. Tool names follow verb_noun convention (mc_test, mc_deploy, mc_upgrade, mc_setup, mc_search_docs_semantic, erc7201_slot), which is good. However, most tools lack detailed parameter descriptions and output schemas are not documented. Only mc_search_docs_semantic and mc_deploy/mc_upgrade have visible parameter schemas with descriptions. Error handling guidance is absent. No tool annotations (readOnlyHint/destructiveHint) despite clear risk classifications. Descriptions are adequate (10-100 chars) but lack context on when to use each tool or what they return.
Calculate ERC7201 storage slot for a given namespace.
Deploy a smart contract using a Forge script.
Search documentation using semantic search with natural language queries.
Initialize a new metacontract project in the current directory.
Run 'forge test' in the workspace.
Upgrade a smart contract using a Forge script.
Missing output schema documentation for all tools. LLMs cannot plan downstream calls or extract required fields without knowing what each tool returns.
Irreversible tools (mc_deploy, mc_upgrade) lack dry-run confirmation or explicit error guidance. No recovery instructions if deployment fails.
Tool descriptions are too brief (10-60 chars) and lack context on WHEN to use each tool or WHAT it returns. Descriptions should be 50-200 chars with actionable guidance.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk classifications (READ_ONLY, IRREVERSIBLE, WRITE). These hints are required for safe agent planning.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | <=2025-11-25 | v2 |
mc_search_docs_semantic 'limit' parameter lacks min/max bounds. Unbounded integers can cause performance issues or context window exhaustion.