Armor Crypto MCP

Instructions

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)