Armor Crypto MCP

Instructions

Unarchive wallet groups.

Expects a list of group names, returns a list of GroupArchiveOrUnarchiveResponse.

Implementation Reference

• armor_crypto_mcp/armor_mcp.py:370-384 (handler)

  MCP tool handler and registration for unarchive_wallet_group. Thin wrapper that authenticates and delegates to ArmorWalletAPIClient.unarchive_wallet_group.

  @mcp.tool()
  async def unarchive_wallet_group(unarchive_wallet_group_requests: UnarchiveWalletGroupRequestContainer) -> List[GroupArchiveOrUnarchiveResponse]:
      """
      Unarchive wallet groups.
      
      Expects a list of group names, returns a list of GroupArchiveOrUnarchiveResponse.
      """
      if not armor_client:
          return [{"error": "Not logged in"}]
      try:
          result: List[GroupArchiveOrUnarchiveResponse] = await armor_client.unarchive_wallet_group(unarchive_wallet_group_requests)
          return result
      except Exception as e:
          return [{"error": str(e)}]

• armor_crypto_mcp/armor_client.py:361-416 (schema)

  Pydantic schemas for input validation: UnarchiveWalletGroupRequest (single group) and UnarchiveWalletGroupRequestContainer (list of requests, used by the tool).

  class UnarchiveWalletGroupRequest(BaseModel):
      group: str = Field(description="Name of the group to unarchive")
  
  class RemoveWalletsFromGroupRequest(BaseModel):
      group: str = Field(description="Name of the group to remove wallets from")
      wallet: str = Field(description="List of wallet names to remove from the group")
  
  class TopTrendingTokensRequest(BaseModel):
      time_frame: Literal["5m", "15m", "30m", "1h", "2h", "3h", "4h", "5h", "6h", "12h", "24h"] = Field(default="24h", description="Time frame to get the top trending tokens")
  
  class StakeBalanceResponse(BaseModel):
      total_stake_amount: float = Field(description="Total stake balance in jupSol")
      total_stake_amount_in_usd: float = Field(description="Total stake balance in USD")
  
  
  class RenameWalletRequest(BaseModel):
      wallet: str = Field(description="Name of the wallet to rename")
      new_name: str = Field(description="New name of the wallet")
  
  
  class CandleStickRequest(BaseModel):
      token_address: str = Field(description="Public mint address of the token. To get the address from a token symbol use `get_token_details`")
      time_interval: Literal["1s", "5s", "15s", "1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "6h", "8h", "12h", "1d", "3d", "1w", "1mn"] = Field(default="1h", description="Time frame to get the candle sticks. Use larger candle time frames over larger time windows to keep returned candles minimal")
      time_from: str = Field(description="The time from which to start the candle data in ISO 8601 format. Attempt to change this to keep number of candles returned under 64.")
      time_to: Optional[str] = Field(default=None, description="The time to end the candle data in ISO 8601 format. Use only for historic analysis.")
      market_cap: Optional[bool] = Field(default=False, description="Whether to return the marketcap of the token instead of the price")
      
  class PrivateKeyRequest(BaseModel):
      wallet: str = Field(description="Name of the wallet to get the mnemonic or private key for")
      key_type: Literal['PRIVATE_KEY', 'MNEMONIC'] = Field(description="Whether to return the private or mnemonic key")
  
  # ------------------------------
  # Container Models for List Inputs
  # ------------------------------
  
  class RemoveWalletsFromGroupRequestContainer(BaseModel):
      remove_wallets_from_group_requests: List[RemoveWalletsFromGroupRequest]
  
  class AddWalletToGroupRequestContainer(BaseModel):
      add_wallet_to_group_requests: List[AddWalletToGroupRequest]
  
  class CreateWalletRequestContainer(BaseModel):
      create_wallet_requests: List[CreateWalletRequest]
  
  class ArchiveWalletsRequestContainer(BaseModel):
      archive_wallet_requests: List[ArchiveWalletsRequest]
  
  class UnarchiveWalletRequestContainer(BaseModel):
      unarchive_wallet_requests: List[UnarchiveWalletsRequest]
  
  class ArchiveWalletGroupRequestContainer(BaseModel):
      archive_wallet_group_requests: List[ArchiveWalletGroupRequest]
  
  class UnarchiveWalletGroupRequestContainer(BaseModel):
      unarchive_wallet_group_requests: List[UnarchiveWalletGroupRequest]

• armor_crypto_mcp/armor_client.py:651-656 (helper)

  Core implementation in ArmorWalletAPIClient: prepares payload from container and makes POST API call to /wallets/group-unarchive/ endpoint.

  async def unarchive_wallet_group(self, data: UnarchiveWalletGroupRequestContainer) -> List[GroupArchiveOrUnarchiveResponse]:
      """Unarchive the specified wallet groups."""
      # payload = json.dumps([{"group": group_name} for group_name in data.group_names])
      payload = data.model_dump(exclude_none=True)['unarchive_wallet_group_requests']
      return await self._api_call("POST", "wallets/group-unarchive/", payload)

• armor_crypto_mcp/armor_client.py:198-200 (schema)

  Pydantic model for the response from unarchiving a wallet group.

  group: str = Field(description="name of the group")