search_token_details

Instructions

Search and retrieve details about single token.
If only address or symbol is needed, use get_official_token_address first.

Expects a TokenSearchRequest, returns a list of TokenDetailsResponse.

Implementation Reference

• armor_crypto_mcp/armor_mcp.py:225-239 (handler)

  MCP tool handler function for search_token_details. Registers the tool via @mcp.tool() decorator and implements the logic by delegating to armor_client.search_token().

  @mcp.tool()
  async def search_token_details(token_search_requests: TokenSearchRequest) -> TokenSearchResponseContainer:
      """
      Search and retrieve details about single token.
      If only address or symbol is needed, use get_official_token_address first.
      
      Expects a TokenSearchRequest, returns a list of TokenDetailsResponse.
      """
      if not armor_client:
          return [{"error": "Not logged in"}]
      try:
          result: TokenSearchResponseContainer = await armor_client.search_token(token_search_requests)
          return result
      except Exception as e:
          return [{"error": str(e)}]

• armor_crypto_mcp/armor_client.py:134-139 (schema)

  Pydantic input schema model for the tool: TokenSearchRequest defining query, sort_by, sort_order, and limit parameters.

  class TokenSearchRequest(BaseModel):
      query: str = Field(description="token symbol or address")
      sort_by: Optional[Literal['decimals', 'holders', 'jupiter', 'verified', 'liquidityUsd', 'marketCapUsd', 'priceUsd', 'totalBuys', 'totalSells', 'totalTransactions', 'volume_5m', 'volume', 'volume_15m', 'volume_30m', 'volume_1h', 'volume_6h', 'volume_12h', 'volume_24h']] = Field(description="Sort token data results by this field")
      sort_order: Optional[Literal['asc', 'desc']] = Field(default='desc', description="The order of the sorted results")
      limit: Optional[int] = Field(default=10, description="The number of results to return from the search. Use default unless specified. Should not be over 30 if looking up multiple tokens.")

• armor_crypto_mcp/armor_client.py:140-168 (schema)

  Pydantic output schema model for individual token details: TokenSearchResponse with fields like name, symbol, mint_address, market data, etc.

  class TokenSearchResponse(BaseModel):
      name: str = Field(description="name of the token")
      symbol: str = Field(description="symbol of the token")
      mint_address: Optional[str] = Field(description="mint address of the token")
      decimals: Optional[int] = Field(description="number of decimals of the token, returns only if include_details is True")
      image: Optional[str] = Field(description="image url of the token, returns only if include_details is True")
      holders: Optional[int] = Field(description="number of holders of the token, returns only if include_details is True")
      jupiter: Optional[bool] = Field(description="whether the token is supported by Jupiter, returns only if include_details is True")
      verified: Optional[bool] = Field(description="whether the token is verified, returns only if include_details is True")
      liquidityUsd: Optional[float] = Field(description="liquidity of the token in USD, returns only if include_details is True")
      marketCapUsd: Optional[float] = Field(description="market cap of the token in USD, returns only if include_details is True")
      priceUsd: Optional[float] = Field(description="price of the token in USD, returns only if include_details is True")
      lpBurn: Optional[float] = Field(description="lp burn of the token, returns only if include_details is True")
      market: Optional[str] = Field(description="market of the token, returns only if include_details is True")
      freezeAuthority: Optional[str] = Field(description="freeze authority of the token, returns only if include_details is True")
      mintAuthority: Optional[str] = Field(description="mint authority of the token, returns only if include_details is True")
      poolAddress: Optional[str] = Field(description="pool address of the token, returns only if include_details is True")
      totalBuys: Optional[int] = Field(description="total number of buys of the token, returns only if include_details is True")
      totalSells: Optional[int] = Field(description="total number of sells of the token, returns only if include_details is True")
      totalTransactions: Optional[int] = Field(description="total number of transactions of the token, returns only if include_details is True")
      volume: Optional[float] = Field(description="volume of the token, returns only if include_details is True")
      volume_5m: Optional[float] = Field(description="volume of the token in the last 5 minutes, returns only if include_details is True")
      volume_15m: Optional[float] = Field(description="volume of the token in the last 15 minutes, returns only if include_details is True")
      volume_30m: Optional[float] = Field(description="volume of the token in the last 30 minutes, returns only if include_details is True")
      volume_1h: Optional[float] = Field(description="volume of the token in the last 1 hour, returns only if include_details is True")
      volume_6h: Optional[float] = Field(description="volume of the token in the last 6 hours, returns only if include_details is True")
      volume_12h: Optional[float] = Field(description="volume of the token in the last 12 hours, returns only if include_details is True")
      volume_24h: Optional[float] = Field(description="volume of the token in the last 24 hours, returns only if include_details is True")

• armor_crypto_mcp/armor_client.py:453-454 (schema)

  Pydantic container model for the tool output: TokenSearchResponseContainer wrapping a list of TokenSearchResponse.

  class TokenSearchResponseContainer(BaseModel):
      token_search_responses: List[TokenSearchResponse]

• armor_crypto_mcp/armor_client.py:597-600 (helper)

  Supporting method in ArmorWalletAPIClient that performs the HTTP API call to the backend for token search, used by the tool handler.

  async def search_token(self, data: TokenSearchRequest) -> TokenSearchResponseContainer:
      """Get details of a token."""
      payload = data.model_dump(exclude_none=True)
      return await self._api_call("POST", "tokens/search-token/", payload)