Armor Crypto MCP

Instructions

Implementation Reference

• armor_crypto_mcp/armor_mcp.py:610-623 (handler)

  MCP tool handler and registration for 'get_token_candle_data'. Wraps the Armor client call to fetch candle data for a token.

  @mcp.tool()
  async def get_token_candle_data(candle_stick_requests: CandleStickRequest) -> List:
      """
      Get candle data about any token for analysis.
  
      Expects a CandleStickRequest, returns a list of candle sticks.
      """
      if not armor_client:
          return [{"error": "Not logged in"}]
      try:
          result: List = await armor_client.get_market_candle_data(candle_stick_requests)
          return result
      except Exception as e:
          return [{"error": str(e)}]

• armor_crypto_mcp/armor_client.py:381-387 (schema)

  Input schema (Pydantic model) for the get_token_candle_data tool: CandleStickRequest defining token address, time interval, time range, and market cap option.

  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")

• armor_crypto_mcp/armor_client.py:715-718 (helper)

  Helper method in ArmorWalletAPIClient that performs the actual API call to retrieve token candle data, invoked by the tool handler.

  async def get_market_candle_data(self, data: CandleStickRequest) -> Dict:
      """Get the candle sticks."""
      payload = data.model_dump(exclude_none=True)
      return await self._api_call("POST", f"tokens/candles/", payload)