Armor Crypto MCP

Instructions

Execute a stake transaction.

Expects a StakeTransactionRequestContainer, returns a SwapTransactionRequestContainer.

Implementation Reference

• armor_crypto_mcp/armor_mcp.py:530-543 (handler)

  The primary handler and registration (@mcp.tool()) for the 'stake_transaction' tool. Proxies requests to the ArmorWalletAPIClient.stake_transaction method, handling authentication check and errors.

  @mcp.tool()
  async def stake_transaction(stake_transaction_requests: StakeTransactionRequestContainer) -> SwapTransactionRequestContainer:
      """
      Execute a stake transaction.
      
      Expects a StakeTransactionRequestContainer, returns a SwapTransactionRequestContainer.
      """
      if not armor_client:
          return [{"error": "Not logged in"}]
      try:
          result: SwapTransactionRequestContainer = await armor_client.stake_transaction(stake_transaction_requests)
          return result
      except Exception as e:
          return [{"error": str(e)}]

• armor_crypto_mcp/armor_client.py:83-85 (schema)

  Pydantic model defining the input schema for a single stake transaction request, containing the transaction_id from a prior stake quote.

  class StakeTransactionRequest(BaseModel):
      transaction_id: str = Field(description="unique id of the generated stake quote")

• armor_crypto_mcp/armor_client.py:445-447 (schema)

  Pydantic container model wrapping a list of StakeTransactionRequest for batch input to the stake_transaction tool.

  class StakeTransactionRequestContainer(BaseModel):
      stake_transaction_requests: List[StakeTransactionRequest]

• armor_crypto_mcp/armor_client.py:583-587 (helper)

  Helper method in ArmorWalletAPIClient that performs the actual API call to execute stake transactions via the /transactions/swap/ endpoint.

  async def stake_transaction(self, data: StakeTransactionRequestContainer) -> StakeTransactionRequestContainer:
      """Execute the stake transactions."""
      payload = data.model_dump(exclude_none=True)['stake_transaction_requests']
      return await self._api_call("POST", "transactions/swap/", payload)