Build unsigned transactions for pending actions on an existing DeFi position — c

Build unsigned transactions for pending actions on an existing DeFi position — claim rewards, restake, unlock, or complete a withdrawal — across 80+ networks. Use the action type and passthrough from yields_get_balances pendingActions[]. Does NOT execute: the caller signs and broadcasts each tx.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://mcp.yield.xyz/x402/actions_manage

Our checks, last 30 days

We never call tools that send, buy, move money or file anything, not even without paying.

Example input (from the provider)

{
  "body": {
    "action": "CLAIM_REWARDS",
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "passthrough": "aaabbbcccdddeeefff",
    "yieldId": "ethereum-matic-native-staking"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "properties": {
            "action": {
              "description": "Pending action type from yields_get_balances pendingActions[].type, e.g. \"CLAIM_REWARDS\", \"RESTAKE_REWARDS\", \"UNLOCK\", \"WITHDRAW\"",
              "type": "string"
            },
            "address": {
              "description": "Wallet address that owns the position",
              "type": "string"
            },
            "amount": {
              "description": "Human-readable token amount, when the action requires one",
              "type": "string"
            },
            "passthrough": {
              "description": "Opaque token from yields_get_balances pendingActions[].passthrough \u2014 pass it back verbatim",
              "type": "string"
            },
            "yieldId": {
              "description": "Yield ID of the position, e.g. \"ethereum-matic-native-staking\"",
              "type": "string"
            }
          },
          "required": [
            "yieldId",
            "address",
            "action",
            "passthrough"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "description": "Core fields shown; responses may carry additional yield-specific fields depending on the protocol (this schema is intentionally non-exhaustive).",
          "properties": {
            "address": {
              "type": "string"
            },
            "amount": {
              "type": [
                "string",
                "null"
              ]
            },
            "createdAt": {
              "type": "string"
            },
            "executionPattern": {
              "enum": [
                "synchronous",
                "asynchronous",
                "batch"
              ],
              "type": "string"
            },
            "id": {
              "description": "Action ID \u2014 poll status later with actions_get",
              "type": "string"
            },
            "intent": {
              "description": "\"enter\", \"exit\", or \"manage\"",
              "type": "string"
            },
            "status": {
              "description": "\"CREATED\" on success; poll until SUCCESS/FAILED",
              "type": "string"
            },
            "transactions": {
              "description": "Sign and broadcast each transaction in stepIndex order, then report each hash via submit_hash. NEVER modify unsignedTransaction.",
              "items": {
                "properties": {
                  "gasEstimate": {
                    "type": "string"
                  },
                  "id": {
                    "type": "string"
                  },
                  "isMessage": {
                    "description": "When true, sign as a message instead of a transaction",
                    "type": "boolean"
                  },
                  "network": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "stepIndex": {
                    "type": "integer"
                  },
                  "title": {
                    "type": "string"
                  },
                  "type": {
                    "description": "e.g. \"APPROVAL\", \"SUPPLY\", \"STAKE\"",
                    "type": "string"
                  },
                  "unsignedTransaction": {
                    "description": "Raw transaction to sign \u2014 a JSON string on EVM chains, an object on non-EVM chains. Never modify it."
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "type": {
              "description": "Action type, e.g. \"STAKE\", \"UNSTAKE\", \"CLAIM_REWARDS\"",
              "type": "string"
            },
            "yieldId": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON