TypeScript MCP server for Bitcoin and Ethereum blockchain read-only interactions
25 tools with complete schemas and descriptions, but significant quality gaps. Most tool descriptions are adequate (50-150 chars) but lack actionable context for LLM selection. Parameter descriptions are sparse or missing entirely. No output schemas documented. Error handling is minimal, tools throw generic errors without recovery guidance. Tool naming is consistent (verb_noun pattern) but some tools conflate multiple concerns (e.g., batch_request, monitor_account). No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Composition issues: batch_request and switch_network duplicate functionality already present in individual tools.
Execute multiple tool calls in a batch
Analyze UTXO set for an address (count, total value, distribution)
Decode a raw transaction hex string
Get current fee estimates (sat/vB)
Get confirmed and unconfirmed balance for a Bitcoin address
Get block details by hash or height
Get transaction details by ID
No output schemas documented. Tools return results but LLMs cannot predict response structure for downstream chaining. Violates pattern:tool and mxe:include-chaining-ids.
Parameter descriptions missing or minimal. 'networkId' appears in 20+ tools with identical description 'Network ID (e.g. bitcoin-mainnet)', no guidance on valid values, defaults, or consequences of omission. Violates pattern:tool-description.
Composition violation: batch_request and switch_network duplicate functionality already present in individual tools (bitcoin_*, eth_*, switch_network). Agents waste reasoning cycles deciding between canonical and batch variants. Violates pattern:tool.
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2025-06-18+ | v2 |
Get unspent transaction outputs for an address
Estimate gas for a transaction (L2 specific or generic)
Validate an Ethereum address
Get ETH balance for an address
Get block by number or hash. By default excludes full transaction data to reduce response size.
Get chain ID for a network
Get latest block. By default excludes full transaction data to reduce response size.
Get network stats (gas price, block number)
Get transaction count (nonce)
Get ERC20 token balance
Get transaction details
Get transaction receipt status
Switch network context (simulated)
Check if a contract is verified on the block explorer
Get the currently active network context
Get usage examples and documentation
Get comprehensive status of an account including balance and transaction count
Switch the default network context
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All 25 tools are read-only but lack explicit annotation. Prevents agents from optimizing retry logic and caching strategies.
Error handling lacks recovery guidance. Tools throw generic errors (e.g., 'Invalid Bitcoin network ID') without suggesting alternatives or next steps. Violates pattern:recovery-guide.