| name | yield-xyz-agentkit-moonpay |
| description | The MoonPay connector for the Yield.xyz AgentKit — signs and broadcasts via MoonPay. Extends the yield-xyz-agentkit skill — that skill discovers yields and builds the unsigned transactions; this one adds MoonPay wallet auth, signing, and broadcasting. Use when the user wants to enter, exit, or manage yield positions end-to-end via a MoonPay wallet. Requires the yield-xyz-agentkit skill + Yield.xyz MCP and the MoonPay MCP. |
| metadata | {"author":"Yield.xyz","version":"1.0.0","mcp-server":"yield-xyz-agentkit"} |
Yield.xyz AgentKit × MoonPay
The MoonPay connector for the Yield.xyz AgentKit: MoonPay handles wallet auth and signs + broadcasts the transactions that yield-xyz-agentkit builds.
yield-xyz-agentkit (this skill's base) owns all yield logic — discovery, schemas, validator selection, balances, building unsignedTransaction (actions_enter / actions_exit / actions_manage), output formatting, and the MCP tool reference. Use it for all of that; this skill only signs and broadcasts.
MoonPay → confirm auth + wallet (provides the address)
yield-xyz-agentkit → discover yield + build unsignedTransaction
MoonPay → sign + broadcast
yield-xyz-agentkit → submit_hash + poll get_transaction
Two MCPs, One Flow
This skill requires both MCP servers connected:
| MCP | Role |
|---|
| Yield.xyz AgentKit | Yield discovery + transaction building (owned by the yield-xyz-agentkit skill) |
| 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 references/setup.md for
connection instructions.
CRITICAL
- Never modify
unsignedTransaction before signing — not addresses, amounts,
fees, or encoding, on any chain. If anything looks wrong, have yield-xyz-agentkit
build a NEW action. Modifying it will result in permanent loss of funds.
- Never call the Yield.xyz API directly (curl/HTTP) — it requires an API key
and returns
401. All Yield.xyz access goes through the MCP (handled by the
yield-xyz-agentkit skill).
Full Flow
Step 1 — Check MoonPay auth and wallet
Before anything else:
- Call MoonPay
wallet_list to confirm a wallet exists.
- If no wallet or not authenticated, guide the user through login (they receive
an email code; once verified they can proceed).
- Note the wallet address — this is the
address the yield-xyz-agentkit skill
uses in all its calls.
Step 2 — Discover + build (via yield-xyz-agentkit)
Hand off to the yield-xyz-agentkit skill to discover the yield, inspect its schema,
select a validator if required, and build the action — passing the MoonPay
wallet address from Step 1. It returns
transactions[] ordered by stepIndex.
For real-world-asset (real_world_asset) yields, the base runs its RWA eligibility gate (yields_get_kyc_status) before building the enter — never broadcast an RWA enter the base flagged ineligible; it will revert on-chain. See the base skill's RWA notes.
Step 3 — Sign and broadcast via MoonPay
Read references/moonpay-tools.md in full before proceeding — mistakes here
result in permanent loss of funds or silent failure.
Execute each transaction in transactions[] sequentially, in stepIndex order —
never in parallel, never out of order. After MoonPay broadcasts each one, hand back to
yield-xyz-agentkit to record the hash (submit_hash, mandatory) and poll it to a
terminal status before signing the next — terminal-state semantics are defined in
the base skill. Never begin transaction N+1 until the current one resolves.
Step 4 — Confirm
After all transactions confirm, have the yield-xyz-agentkit skill fetch
yields_get_balances and show the user their new position.
Manage / Exit Flow
yield-xyz-agentkit reads pendingActions[] (yields_get_balances) and builds the
actions_manage / actions_exit action.- Sign each transaction via MoonPay (same as Step 3).
submit_hash after each broadcast (mandatory), then poll to a terminal status before the next — as in Step 3.
Error Handling
| Situation | Action |
|---|
| MoonPay not authenticated | Guide through mp login + email code verification |
| No wallet found | Guide through mp wallet create --name <wallet-name> |
| Transaction FAILED | Do not retry automatically — report to user with txHash |
(For Yield.xyz-side errors — wrong arguments, rate limits — see the
yield-xyz-agentkit skill.)
References
Read on demand:
For everything about discovering yields, building transactions, and output
formatting, use the yield-xyz-agentkit skill.
