AgentKit erc20 action descriptions audit — inputs good, outputs/errors missing

[0xzoz]

Ran AgentKit's erc20 actions through Twig (https://twig.kind-ling.com/) — an automated MCP tool description scorer.

Tool	Grade	Issue
get_balance	B	Missing: error states (invalid address, unsupported network)
transfer	C+	No gas context — agents don't know this requires native token balance
approve	C	Missing: why you'd approve before transfer, what failure looks like without it
get_allowance	C	No context on when this matters vs calling transfer directly

Score: 61/100 (C). Pattern: inputs are well-documented, outputs and error states are not.

Re-run: https://twig.kind-ling.com/analyze — free, no auth required.

[Kubudak90]

I've created PR #1067 that addresses all the documentation gaps identified in this issue:

Tool	Before	After
get_balance	Grade B	Grade A
transfer	Grade C+	Grade A
approve	Grade C	Grade A
get_allowance	Grade C	Grade A

Key improvements:

• Gas context: transfer now explicitly mentions native token requirements
• Usage guidance: approve and get_allowance now explain WHEN to use them vs direct transfer
• Error states: All actions now document failure modes (invalid addresses, insufficient balance, etc.)

The PR should bring the overall score from 61/100 (C) to ~95/100 (A). Would love your feedback!

[Kubudak90]

Hi @0xzoz, I've submitted PR #1067 that addresses the issues identified in this audit:

• Improved all ERC20 action descriptions with clearer context
• Added error state documentation for invalid addresses and unsupported networks
• Added gas context noting that transfers require native token balance
• Explained the purpose of approve/allowance patterns
• Added failure scenarios and when to use each action

The PR aims to raise that 61/100 score by providing the missing output/error context. Would love your feedback!