From 4ffe95b855294aca38c612e327fa1817c3a90184 Mon Sep 17 00:00:00 2001 From: Ishita Agarwal Date: Fri, 10 Apr 2026 12:18:24 +0530 Subject: [PATCH 1/5] fix: remove claude specific names and generalize for all AI agents --- .../skills/yield-agentkit-moonpay/README.md | 39 ++++++++----------- .../skills/yield-agentkit-moonpay/SKILL.md | 2 +- .../references/key-rules.md | 11 +++--- .../references/moonpay-tools.md | 1 + .../references/setup.md | 7 ++++ 5 files changed, 31 insertions(+), 29 deletions(-) diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md index 1f23da6..4d1e140 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md @@ -1,6 +1,6 @@ # Yield.xyz AgentKit Skill × MoonPay Skill -> **End-to-end on-chain yield, fully in Claude.** This skill combines Yield.xyz's yield discovery and transaction building with MoonPay's wallet authentication, signing, and broadcasting — so you can go from "find me ETH staking yields" to a confirmed on-chain position without leaving your AI assistant. +> **End-to-end on-chain yield.** This skill combines Yield.xyz's yield discovery and transaction building with MoonPay's wallet authentication, signing, and broadcasting — so you can go from "find me ETH staking yields" to a confirmed on-chain position without leaving your AI assistant. --- @@ -16,8 +16,8 @@ Yield.xyz AgentKit MCP MoonPay MCP ───────────── ─────────── yields_get_all → wallet_list (get address) yields_get → check balance -actions_enter → wallet_send_transaction (sign + broadcast) -submit-hash ← txHash returned +actions_enter → transaction_sign + transaction_send (sign + broadcast) + ← txHash returned yields_get_balances confirm position ``` @@ -39,20 +39,20 @@ yields_get_balances confirm position ## Install -Open Claude Code and say: +Open your AI Agent and say: ``` Set up the yield-agentkit-moonpay skill ``` -Claude will read `references/setup.md` and automatically: +The agent will read `references/setup.md` and automatically: - Register the Yield.xyz AgentKit MCP (if not already connected) - Check if the MoonPay CLI is installed, and install it if needed - Check if you're already logged in to MoonPay, and run the login flow only if needed - Check for existing wallets, and create one only if none exist - Register the MoonPay MCP server (if not already connected) -The only moments Claude will pause and ask for your input are: +The only moments the agent will pause and ask for your input are: - Your MoonPay email address (if login is needed) - The verification code sent to your email (if login is needed) - A wallet name (if wallet creation is needed) @@ -99,7 +99,7 @@ You can fund it by: ``` Buy 100 USDC on Base via MoonPay ``` - Claude will trigger the MoonPay on-ramp flow inside the conversation. + The agent will trigger the MoonPay on-ramp flow inside the conversation. Once funded, confirm your balance: ``` @@ -114,9 +114,6 @@ Then you're ready to enter yield positions. Once both MCPs are connected: -``` -Stake 1 ETH on Ethereum via my MoonPay wallet -``` ``` Find the best USDC yields on Base and deposit 100 USDC ``` @@ -126,11 +123,9 @@ Show me ETH liquid staking options, I want to use Lido ``` Check my current yield positions for my MoonPay wallet ``` -``` -Claim my staking rewards -``` -Claude will automatically load the skill, call the right tools in order, + +The agent will automatically load the skill, call the right tools in order, confirm each step with you before signing, and submit the transaction hash back to Yield.xyz after broadcasting. @@ -152,18 +147,18 @@ where most yield opportunities exist. ```bash claude mcp list -# Should show: yield-agentkit, moonpay +# Should show: yield-agentkit, moonpay (if using claude) ``` -If either MCP is missing, ask Claude to set up the skill: +If either MCP is missing, ask the agent to set up the skill: ``` Set up the yield-agentkit-moonpay skill ``` -Claude will read `references/setup.md` and resolve any missing MCPs automatically. +The agent will read `references/setup.md` and resolve any missing MCPs automatically. -### Step 2 — Open Claude Code and check skill is loaded +### Step 2 — Open the agent and check skill is loaded **Option 1** — view loaded skills via `/context`: ``` @@ -186,7 +181,7 @@ What wallets do I have in MoonPay? ``` If you see a wallet address → you're authenticated and ready. -If you get an auth error → ask Claude to re-authenticate: `Re-authenticate my MoonPay wallet` +If you get an auth error → ask the agent to re-authenticate: `Re-authenticate my MoonPay wallet` ### Step 4 — Test Yield.xyz independently @@ -210,7 +205,7 @@ Get full details on ethereum-eth-lido-staking I want to stake 0.01 ETH via Lido using my MoonPay wallet ``` -Watch Claude: +Watch your AI agent: 1. Call `wallet_list` → get your address 2. Call `yields_get` → inspect the schema 3. Call `actions_enter` → build the transaction @@ -224,10 +219,10 @@ Watch Claude: | Symptom | Fix | |---|---| | Skill not triggering | Run `/yield-agentkit-moonpay find ETH yields` to force-invoke | -| MoonPay auth error | Ask Claude: `Re-authenticate my MoonPay wallet` | +| MoonPay auth error | Ask the agent: `Re-authenticate my MoonPay wallet` | | `transaction_sign` fails | Check wallet has enough balance: `mp wallet list` | | Balances not updating | Hash submission was skipped — re-enter position or submit manually | -| Skill missing from `/context` | Wrong install path — check `ls .claude/skills/` | +| Skill missing from `/context` | Ask the agent to check and reload the skill. | --- diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/SKILL.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/SKILL.md index 695d61f..28caefc 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/SKILL.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/SKILL.md @@ -29,7 +29,7 @@ This skill requires both MCP servers to be connected: | **MoonPay** | Auth + wallet + sign + broadcast | `wallet_list`, `transaction_sign`, `transaction_send`, `token_balance_list` and more | If either MCP is missing, stop and tell the user. See -`{baseDir}/references/setup.md` for connection instructions. +`references/setup.md` for connection instructions. --- diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/key-rules.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/key-rules.md index e99a39a..d0cbc1d 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/key-rules.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/key-rules.md @@ -24,17 +24,16 @@ ## MoonPay rules -7. **Get wallet address first.** Call `wallet_list` before any yield action. +6. **Get wallet address first.** Call `wallet_list` before any yield action. The wallet address from MoonPay = the `address` param in all Yield.xyz calls. -8. **Never modify `unsignedTransaction` before passing to MoonPay.** +7. **Never modify `unsignedTransaction` before passing to MoonPay.** Pass the complete object exactly as returned by Yield.xyz. -9. **Capture `txHash` from every `wallet_send_transaction` call.** - Submit it to Yield.xyz immediately after — do not wait. +8. **Capture `txHash` from every `transaction_send` call.** -10. **Verify wallet balance before entering a position.** - Call `wallet_balance` first. If insufficient, tell the user clearly. +9. **Verify wallet balance before entering a position.** + Call `token_balance_list` first. If insufficient, tell the user clearly. --- diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/moonpay-tools.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/moonpay-tools.md index f87a2e7..1ac18d7 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/moonpay-tools.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/moonpay-tools.md @@ -13,6 +13,7 @@ List all local wallets and their addresses. ### `token_balance_list` Get token balances for a wallet. +- Both `wallet` and `chain` are required - Use to verify the user has enough funds before calling `actions_enter` - Use to confirm a position was entered after hash submission diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md index dfd2a97..2f0a6a8 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md @@ -15,6 +15,13 @@ Run `claude mcp list` and check if `yield-agentkit` is already registered. claude mcp add yield-agentkit --transport http https://mcp.yield.xyz/mcp ``` +If not using claude then add this MCP: + +```bash +MCP name: yield-agentkit +MCP URL: https://mcp.yield.xyz/mcp +``` + --- ## 2. MoonPay MCP From 2ded5204213d576d5189a1c9bfef00caec9517d5 Mon Sep 17 00:00:00 2001 From: Ishita Agarwal Date: Fri, 10 Apr 2026 20:13:38 +0530 Subject: [PATCH 2/5] feat: add yield mcp config --- .../skills/yield-agentkit-moonpay/references/setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md index 2f0a6a8..b44de46 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md @@ -15,7 +15,7 @@ Run `claude mcp list` and check if `yield-agentkit` is already registered. claude mcp add yield-agentkit --transport http https://mcp.yield.xyz/mcp ``` -If not using claude then add this MCP: +If not using claude then determine the AI Agent/IDE and add this MCP: ```bash MCP name: yield-agentkit From c161a1421e85ec39c7389e908da8f7824c22d4bd Mon Sep 17 00:00:00 2001 From: Ishita Agarwal Date: Fri, 10 Apr 2026 20:32:20 +0530 Subject: [PATCH 3/5] fix: modified rule 7 in key rules --- .../skills/yield-agentkit-moonpay/README.md | 3 ++- .../skills/yield-agentkit-moonpay/references/key-rules.md | 5 +++-- .../skills/yield-agentkit-moonpay/references/setup.md | 5 ++++- 3 files changed, 9 insertions(+), 4 deletions(-) diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md index 4d1e140..85fe006 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md @@ -30,7 +30,8 @@ yields_get_balances confirm position | Requirement | Details | |---|---| -| Claude Code | [Install guide](https://code.claude.com/docs/en/quickstart) | +|Yield AgentKit MCP | https://mcp.yield.xyz/mcp +|MoonPay MCP | mp | MoonPay CLI | `npm install -g @moonpay/cli` | | MoonPay account | Free — created via `mp login` | | Node.js | v18 or higher (for MoonPay CLI) | diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/key-rules.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/key-rules.md index d0cbc1d..268c0c4 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/key-rules.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/key-rules.md @@ -27,8 +27,9 @@ 6. **Get wallet address first.** Call `wallet_list` before any yield action. The wallet address from MoonPay = the `address` param in all Yield.xyz calls. -7. **Never modify `unsignedTransaction` before passing to MoonPay.** - Pass the complete object exactly as returned by Yield.xyz. +7. **Never alter transaction values from `unsignedTransaction` returned by Yield.xyz.** + + For `transaction_sign`, serialize the unsigned tx to base64 RLP exactly as documented in `references/moonpay-tools.md` (format conversion only; no value changes). 8. **Capture `txHash` from every `transaction_send` call.** diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md index b44de46..1cc8634 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/references/setup.md @@ -15,13 +15,16 @@ Run `claude mcp list` and check if `yield-agentkit` is already registered. claude mcp add yield-agentkit --transport http https://mcp.yield.xyz/mcp ``` -If not using claude then determine the AI Agent/IDE and add this MCP: +If not using claude, register the MCP in agent/IDE's MCP settings with:: ```bash MCP name: yield-agentkit MCP URL: https://mcp.yield.xyz/mcp +Transport: http ``` +Then verify in your agent that `yield-agentkit` appears in the connected MCP list before continuing. + --- ## 2. MoonPay MCP From 8dbb83627cef56595051dfbe822f2d34d06ebd27 Mon Sep 17 00:00:00 2001 From: Ishita Agarwal Date: Fri, 10 Apr 2026 20:48:13 +0530 Subject: [PATCH 4/5] add: install command --- .../skills/yield-agentkit-moonpay/README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md index 85fe006..8229295 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md @@ -40,6 +40,16 @@ yields_get_balances confirm position ## Install + +### Install via `npx skills` (recommended) + +```bash +npx skills add https://github.com/stakekit/agentkit +``` + +The CLI will list all available skills, pick `yield-agentkit-moonpay` + + Open your AI Agent and say: ``` From e94386c35fa2475bee2c8b140f61b8518417f1c3 Mon Sep 17 00:00:00 2001 From: Ishita Agarwal Date: Fri, 10 Apr 2026 20:57:25 +0530 Subject: [PATCH 5/5] fix: transaction_sign fail instruction fix --- yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md b/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md index 8229295..b9d2cb7 100644 --- a/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md +++ b/yield-agentkit-skills/skills/yield-agentkit-moonpay/README.md @@ -231,7 +231,7 @@ Watch your AI agent: |---|---| | Skill not triggering | Run `/yield-agentkit-moonpay find ETH yields` to force-invoke | | MoonPay auth error | Ask the agent: `Re-authenticate my MoonPay wallet` | -| `transaction_sign` fails | Check wallet has enough balance: `mp wallet list` | +| `transaction_sign` fails | Ask the agent to check if wallet has enough balance | | Balances not updating | Hash submission was skipped — re-enter position or submit manually | | Skill missing from `/context` | Ask the agent to check and reload the skill. |