Using Privy server wallets with yield.xyz AgentKit

Give AI agents access to 3,300+ yield opportunities across 80+ blockchain networks. Yield.xyz AgentKit discovers and constructs unsigned transactions for staking, lending, vaults, liquid staking, and restaking. Privy handles wallet creation, policy enforcement, and transaction signing. The two systems never overlap: Yield.xyz never signs, Privy never builds transactions.

Resources

Yield.xyz AgentKit

GitHub repository for the Yield.xyz AgentKit MCP server.

Yield.xyz AgentKit docs

Official documentation for the Yield.xyz AgentKit.

Privy agentic wallets

Set up Privy server wallets for autonomous agents.

Privy manual approvals

Intents API reference for semi-autonomous workflows.

What is Yield.xyz AgentKit?

Yield.xyz AgentKit is an MCP server that provides AI agents with tools to search yield opportunities, build deposit/withdraw/claim transactions, and check balances across 80+ networks. All yield operations go through MCP tools — agents never call the Yield.xyz REST API directly.

Tool	Purpose
`yields_get_all`	Search and filter yields by network, token, type, or provider
`yields_get`	Retrieve full metadata for a specific yield
`yields_get_validators`	Fetch validator options for delegation-based yields
`yields_get_balances`	Check balances and pending actions
`actions_enter`	Build transactions to deposit or stake into a yield
`actions_exit`	Build transactions to withdraw or unstake from a yield
`actions_manage`	Build transactions for pending actions (claim rewards, restake)
`networks_get_all`	List all supported networks
`providers_get_all`	List all supported yield protocols
`yields_get_risk`	Fetch the aggregate risk rating for a yield
`yields_get_reward_rate_history`	Get the historical APY/reward-rate time series for a yield
`yields_get_tvl_history`	Get the historical TVL time series for a yield
`actions_get`	Fetch the status and transactions for a single action
`actions_get_all`	List past and pending actions for a wallet
`get_transaction`	Poll the status and details of a single transaction
`submit_hash`	Register a broadcast hash for an unsigned transaction
`yields_get_kyc_status`	Check a wallet’s KYC and eligibility status for a permissioned yield

Yield.xyz AgentKit is maintained by the Yield.xyz team. For AgentKit-specific issues, refer to their GitHub repository.

Use cases

Search and compare yield opportunities across networks
Enter and exit yield opportunities (staking, lending, vaults, RWAs)
Rebalance and rotate strategies
Claim rewards and manage positions
Monitor portfolios

DeFi yields

Access a broad range of yield opportunities across the DeFi ecosystem, including lending protocols, vaults, yield aggregators, and liquidity provisioning on DEXs. Agents can compare protocols using live metrics like TVL, historic APY, and risk scores to make optimal allocation decisions. Supported protocols include Aave, Spark, Sky, Morpho, Curve, Ethena, Lido, Upshift, Marinade, SummerFi, EtherFi, Compound, Maple, Euler, Yo Protocol, Fluid, and more.

RWA yields

Access tokenized real-world assets — US Treasuries, private credit, CLOs, and institutional funds — on-chain. RWA yields are supported across both permissionless and KYC-gated providers, with built-in eligibility handling so agents never submit a transaction to a non-allowlisted wallet. Supported providers include Superstate, Midas, Ondo, Dinari, Nest, and Securitize.

Eligibility gates: Before entering any RWA position, the agent automatically runs an eligibility check.

Permissioned providers: The agent checks KYC status. If the wallet is approved, it proceeds to build and submit the transaction. If the wallet is not yet approved, the agent surfaces the issuer’s onboarding URL to complete KYC and stops — no transaction is submitted until the wallet is eligible.
Open-access providers: No allowlist gate applies. The agent confirms jurisdiction eligibility and proceeds directly to build and submit the transaction.

Staking yields

Agents can stake across multiple networks, delegate to any active validator, compare commissions and reward rates, and perform all staking actions — stake, redelegate, unstake, and claim rewards. Supported staking opportunities include Ethereum, Hyperliquid, Solana, Polygon, BNB, Avalanche, and others.

Demos

Autonomous — Portfolio Rebalance on Base
Network: Base · Workflow: Autonomous
Pre-condition: USDC deposited into Aave V3, Morpho, and Fluid via the Privy agent wallet.

Semi-Autonomous — Split Deposit on Solana
Network: Solana · Workflow: Semi-Autonomous (Enterprise)
Pre-condition: Wallet funded with USDC on Solana, SOL for rent. Key quorum and approver configured.

RWA Autonomous Flow - Dinari Midas Rebalancing Network: Base · Workflow: Autonomous
Pre-condition: An active position on Midas base

Prerequisites

A Privy account with API credentials (dashboard.privy.io)
PRIVY_APP_ID and PRIVY_APP_SECRET set as environment variables
Optionally PRIVY_WALLET_ID if a wallet already exists
Claude Code installed
Privy Enterprise plan (required for the semi-autonomous workflow only)

This skill does not set up or manage Privy credentials. Privy must already be configured in the agent environment before activation.

To set up Privy before continuing: Agentic wallets guide · Privy skill repository · Privy dashboard

Installation

Recommended: Claude Code plugin

Add the marketplace:

/plugin marketplace add stakekit/agentkit

Install the Privy plugin:

/plugin install yield-xyz-agentkit-privy@agentkit

Alternative: skill

npx skills add https://github.com/stakekit/agentkit

The installer prompts for a skill selection (yield-xyz-agentkit-privy) and an agent choice (Claude Code, Cursor, or Codex CLI). Once complete, the skill is symlinked into the project at .agents/skills/yield-xyz-agentkit-privy. Open the agent in the project directory and run:

Set up the yield-xyz-agentkit-privy skill

The skill verifies Privy credentials and prompts for a workflow selection: Autonomous or Semi-Autonomous.

Workflows

Privy supports two control models for Yield.xyz AgentKit depending on approval requirements:

Autonomous — The agent signs and broadcasts transactions directly via Privy’s wallet RPC endpoint. Policies are enforced automatically within the TEE. No manual approval is required. Available on any Privy plan.
Semi-autonomous (Enterprise) — Every transaction is submitted as an intent via Privy’s Intents API. A designated approver must review and approve each transaction on the Privy dashboard before it executes. Intents expire after 72 hours.

Autonomous

The agent signs and broadcasts transactions directly via Privy’s wallet RPC endpoint. Policies are enforced automatically within the TEE. No manual approval is required. Available on any Privy plan.

Verify credentials

The skill checks that PRIVY_APP_ID, PRIVY_APP_SECRET, and optionally PRIVY_WALLET_ID are present.

The skill registers the Yield.xyz AgentKit MCP server:

claude mcp add --transport http yield-agentkit https://mcp.yield.xyz/mcp

Configure a policy (optional)

The skill offers to attach a policy (conservative, balanced, or skip). Policies restrict per-transaction spend, allowed chains, or allowlisted protocols. All enforcement happens inside the TEE.

Create the wallet

The skill creates a wallet and attaches the policy if one was configured.

Fund the wallet

Send assets to the displayed wallet address.

Issue DeFi instructions

The agent is ready. Example prompt: "Deposit USDC into Aave V3 on Base."

Semi-autonomous (Enterprise)

Every transaction is submitted as an intent via Privy’s Intents API. A designated approver must review and approve each transaction on the Privy dashboard before it executes. Intents expire after 72 hours if not approved. Intent statuses: pending (awaiting approval), executed (broadcast), failed (execution error), expired (72h elapsed), rejected (cancelled), dismissed (resource changed).

Complete autonomous setup steps 1–3

Follow the credential verification, MCP registration, and policy configuration steps from the autonomous workflow above.

Confirm Enterprise prerequisites

Verify the Enterprise plan is active and the approver has been invited and completed MFA.

Create a key quorum

Create a key quorum in the Privy dashboard under Wallet Infrastructure → Authorization → New Key → Register Key Quorum Instead. Copy the Quorum ID and provide it to the agent. The agent verifies it via GET /v1/key_quorums/{id}.

Create the wallet

The skill creates the wallet with the key quorum as owner:

POST /v1/wallets
  chain_type: "ethereum"
  owner_id: <key_quorum_id>
  policy_ids: [<policy_id>]

Set up webhooks (optional)

Register an HTTPS endpoint under Configuration → Webhooks in the Privy dashboard and enable all four intent events: intent.created, intent.authorized, intent.executed, and intent.failed. See Privy intent webhooks.For testing without a backend, use webhook.site.

Once setup is complete, every transaction follows this cycle: agent builds via MCP → submits as intent → approver reviews on dashboard → Privy signs and broadcasts → agent polls until executed → reads hash.

Transaction flow

Every yield action — enter, exit, or manage — follows the same sequence:

Call yields_get to inspect the yield schema
Call actions_enter, actions_exit, or actions_manage to build unsigned transactions
MCP returns an array of transactions with stepIndex, type, and unsignedTransaction
For each transaction in stepIndex order:
- Autonomous: POST /v1/wallets/{id}/rpc → immediate hash
- Semi-autonomous: POST /v1/intents/wallets/{id}/rpc → poll until executed
Report results with on-chain confirmation hashes

EVM transactions

Extract only the fields Privy accepts from the unsigned transaction:

PRIVY_TX=$(echo "$UNSIGNED_TX" | jq '{from, to, value, data, nonce, type} | with_entries(select(.value != null))')

Submit to Privy:

# Example uses Base (chainId: 8453)
curl -s -X POST "https://api.privy.io/v1/wallets/$PRIVY_WALLET_ID/rpc" \
  --user "$PRIVY_APP_ID:$PRIVY_APP_SECRET" \
  -H "privy-app-id:$PRIVY_APP_ID" \
  -H "Content-Type: application/json" \
  -d "{
    \"method\":\"eth_sendTransaction\",
    \"caip2\":\"eip155:8453\",
    \"params\": { \"transaction\":$PRIVY_TX }
  }"

Solana transactions

Convert hex to base64 before submitting:

TX_BASE64=$(echo "$UNSIGNED_TX" | xxd -r -p | base64)

curl -s -X POST "https://api.privy.io/v1/wallets/$PRIVY_WALLET_ID/rpc" \
  --user "$PRIVY_APP_ID:$PRIVY_APP_SECRET" \
  -H "privy-app-id:$PRIVY_APP_ID" \
  -H "Content-Type: application/json" \
  -d "{
    \"method\":\"signAndSendTransaction\",
    \"caip2\":\"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\",
    \"params\": { \"transaction\":\"$TX_BASE64\", \"encoding\":\"base64\" }
  }"

Multi-transaction ordering

Transactions are processed sequentially in stepIndex order. For EVM chains, the nonce increments for each subsequent transaction. If any transaction fails, execution stops immediately and the failure is returned.

For detailed transaction guides, see Send EVM transaction and Send Solana transaction.

The skill never modifies values inside an unsignedTransaction. Amounts, recipient addresses, fees, and calldata are passed through exactly as returned by the MCP. Only structural fields are adjusted for Privy’s signing format.

Error handling

Error	Cause	Action
`POLICY_VIOLATION`	Transaction exceeds policy limits	Report which rule triggered. Do not retry without user instruction.
`INSUFFICIENT_FUNDS`	Wallet lacks gas	Ask the user to add native token to the wallet address.
`FAILED`	Transaction failed on-chain	Provide the hash for block explorer inspection. Stop all subsequent transactions.

What cannot be automated

Action	Reason
Fund the agent wallet	Requires an existing external wallet
Invite approver to Privy app	Tied to authenticated user account
Complete MFA	Device-bound
Create key quorum	API requires user ID input — kept manual for better UX
Approve pending intent	By design — this is the point of the workflow
Upgrade to Enterprise	Billing — done on the Privy dashboard
Webhook setup	No API available — done in Configuration → Webhooks in the dashboard

Learn more

Yield.xyz AgentKit

Skill repository and MCP server source.

Yield.xyz AgentKit docs

AgentKit reference documentation.

Yield.xyz AgentKit MCP

MCP server endpoint and setup.

Yield.xyz RWA yields

Tokenized real-world asset reference.

Privy agentic wallets

Wallet setup guide for autonomous agents.

Privy manual approvals

Intents API reference.

Privy webhooks

Webhooks overview for transaction events.

Privy dashboard

Wallet and policy management.

​Resources

Yield.xyz AgentKit

Yield.xyz AgentKit docs

Privy agentic wallets

Privy manual approvals

​What is Yield.xyz AgentKit?

​Use cases

​DeFi yields

​RWA yields

​Staking yields

​Demos

​Prerequisites

​Installation

​Recommended: Claude Code plugin

​Alternative: skill

​Workflows

​Autonomous

​Semi-autonomous (Enterprise)

​Transaction flow

​EVM transactions

​Solana transactions

​Multi-transaction ordering

​Error handling

​What cannot be automated

​Learn more

Yield.xyz AgentKit

Yield.xyz AgentKit docs

Yield.xyz AgentKit MCP

Yield.xyz RWA yields

Privy agentic wallets

Privy manual approvals

Privy webhooks

Privy dashboard

Resources

What is Yield.xyz AgentKit?

Use cases

DeFi yields

RWA yields

Staking yields

Demos

Prerequisites

Installation

Recommended: Claude Code plugin

Alternative: skill

Workflows

Autonomous

Semi-autonomous (Enterprise)

Transaction flow

EVM transactions

Solana transactions

Multi-transaction ordering

Error handling

What cannot be automated

Learn more