MCP server for JPYC commerce platform enabling agent-based task outsourcing, product trading with escrow, trust scoring, and BountyEscrow smart contract integration
19 tools with complete input schemas and descriptions, but quality is inconsistent. Tool names follow verb_noun pattern (get_, evaluate_, propose_, etc.), which is good. However, descriptions are often terse (10-50 chars) and lack actionable context for LLM selection. Parameters are typed but many lack detailed constraints or format guidance. Output schemas are not documented, LLMs cannot predict response structure. Error handling is absent; no recovery guidance. Security-critical tools (execute_payment, purchase, confirm_delivery) lack confirmation patterns or dry-run support. Composition is reasonable (tools chain via IDs), but several tools conflate multiple concerns (e.g., confirm_delivery updates both buyer and seller sentiment in one call).
クライアントが入札を受諾し BountyEscrow.acceptBid の calldata を返す
クライアントが OPEN 状態のバウンティをキャンセルし BountyEscrow.cancelBounty の calldata を返す(OPEN → CANCELLED)
ワーカーが CLAIM_TIMEOUT(90日)経過後に自動払出を請求し BountyEscrow.claimExpired の calldata を返す
買い手が商品の受取を確認し、エスクローから売り手にJPYCをリリースする。双方の信頼スコアを更新
タスクの説明・必要スキル・期限から難易度スコアと推奨報酬レンジを評価する
承認済み交渉に基づいてオンチェーン送金を実行し、支払いIDとトランザクションハッシュを返す
ウォレットアドレスに紐づくエージェントプロフィール(信頼スコア・完遂数・評価)を取得する
No output schemas documented. LLMs cannot predict response structure, forcing them to guess what fields are returned and how to chain tools. This violates pattern:tool and pattern:response-shaper.
Irreversible operations (execute_payment, purchase, confirm_delivery) lack confirmation or dry-run patterns. Agents can trigger financial transactions without a safety gate, risking accidental fund transfers.
Descriptions are too terse (10-50 chars for most tools). Lack context on WHEN to use each tool, prerequisites, and what happens. E.g., 'execute_payment' (35 chars) does not explain it is irreversible or requires prior approval. Violates pattern:tool-description baseline of 50-200 chars.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
売り手が商品を出品する(固定価格)
バウンティを開設し BountyEscrow.openBountyFromAllowance の calldata を返す。事前に JPYC.approve が必要
タスクIDとエージェントウォレットを受け取り、trust_score(+入札額)に基づいた報酬交渉案を提案する。bid_id指定で入札ベースの交渉、カウンターオファーへの再提案にも対応
買い手が商品を購入する。JPYCをエスクローに預託し、受取確認後に売り手へリリース
エージェントがトランザクション実行後に結果(tx_hash)を報告する。execute_paymentやpurchaseの後に呼ぶ
交渉IDを人間に提示し、承認(approved)または却下(rejected)を待つ
受注側エージェントが発注側の交渉提案に対して受諾・拒否・カウンターオファーで応答する
エージェントオーナー(人間)がスキル別の希望単価と入札上限を事前設定する。エージェントはこの範囲内でしか入札できない
受注側エージェントがタスクに対して希望報酬額(見積もり)を提示する
ワーカーが成果物ハッシュを提出し BountyEscrow.submitDeliverable の calldata を返す(ASSIGNED → SUBMITTED)
タスク完了後にエージェントの信頼スコア(trust_score)を更新する
エージェントの信頼スコアをオンチェーンMerkle Rootで検証する
No error handling or recovery guidance. Tools do not document what errors can occur, whether they are retryable, or what the LLM should do next. Violates pattern:recovery-guide and pattern:error-classification.
confirm_delivery conflates two concerns: releasing escrow AND updating sentiment scores for both parties. Should split into separate tools (confirm_delivery + update_sentiment) to allow independent composition. Violates pattern:tool (single responsibility).