Armor Crypto MCP

Instructions

Execute a swap transaction.

Expects a SwapTransactionRequestContainer, returns a list of SwapTransactionResponse.

Implementation Reference

• armor_crypto_mcp/armor_mcp.py:160-173 (handler)

  MCP tool handler for 'swap_transaction': decorated with @mcp.tool(), validates input using SwapTransactionRequestContainer, calls armor_client.swap_transaction, handles errors and returns List[SwapTransactionResponse]

  @mcp.tool()
  async def swap_transaction(swap_transaction_requests: SwapTransactionRequestContainer) -> List[SwapTransactionResponse]:
      """
      Execute a swap transaction.
      
      Expects a SwapTransactionRequestContainer, returns a list of SwapTransactionResponse.
      """
      if not armor_client:
          return [{"error": "Not logged in"}]
      try:
          result: List[SwapTransactionResponse] = await armor_client.swap_transaction(swap_transaction_requests)
          return result
      except Exception as e:
          return [{"error": str(e)}]

• armor_crypto_mcp/armor_client.py:79-81 (schema)

  Pydantic model for individual swap transaction request input, containing the transaction_id from a prior swap quote.

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

• armor_crypto_mcp/armor_client.py:91-98 (schema)

  Pydantic model for swap transaction response, including transaction details, URL, amounts, status, and optional error.

  class SwapTransactionResponse(BaseModel):
      id: str = Field(description="unique id of the swap transaction")
      transaction_error: Optional[str] = Field(description="error message if the transaction fails")
      transaction_url: str = Field(description="public url of the transaction")
      input_amount: float = Field(description="input amount in input token")
      output_amount: float = Field(description="output amount in output token")
      status: str = Field(description="status of the transaction")

• armor_crypto_mcp/armor_client.py:441-442 (schema)

  Container model for batch input to swap_transaction tool, holding a list of SwapTransactionRequest.

  class SwapTransactionRequestContainer(BaseModel):
      swap_transaction_requests: List[SwapTransactionRequest]

• armor_crypto_mcp/armor_client.py:577-582 (helper)

  Client method in ArmorWalletAPIClient that executes the actual API POST to /transactions/swap/ with the prepared payload, invoked by the MCP handler.

  async def swap_transaction(self, data: SwapTransactionRequestContainer) -> List[SwapTransactionResponse]:
      """Execute the swap transactions."""
      # payload = [v.model_dump() for v in data.swap_transaction_requests]
      payload = data.model_dump(exclude_none=True)['swap_transaction_requests']
      return await self._api_call("POST", "transactions/swap/", payload)