BICScan MCP Server

Instructions

Args:
    address: EOA, CA, ENS, CNS, KNS or even HostName
Returns:
    Dict: where summary.bicscan_score is from 0 to 100. 100 is high risk.

Implementation Reference

• src/bicscan_mcp/server.py:68-86 (handler)

  The handler function for the 'get_risk_score' tool. It is decorated with @mcp.tool() which registers it as an MCP tool. Takes an address parameter, makes a POST request to the BICScan API, and returns the risk score dictionary.

  async def get_risk_score(address: str) -> dict:
      """Get Risk Score for Crypto, Domain Name, ENS, CNS, KNS or even Hostname Address
  
      Args:
          address: EOA, CA, ENS, CNS, KNS or even HostName
      Returns:
          Dict: where summary.bicscan_score is from 0 to 100. 100 is high risk.
      """
  
      logger.info(f"Getting risk score for address: {address}")
      endpoint = "/v1/scan"
      data = {
          "query": address,
          "sync": True,
          "assets": False,
      }
  
      return await post_request(endpoint, data=data)

• src/bicscan_mcp/server.py:40-65 (helper)

  Supporting helper function used by get_risk_score to make authenticated POST requests to the BICScan API endpoint.

  async def post_request(
      endpoint: str, data: dict[str, Any] | None = None
  ) -> dict[str, Any] | None:
      """Make a request to BICScan API with proper error handling."""
      headers = {
          "User-Agent": "bicscan-mcp/1.0",
          "Accept": "application/json",
          "X-Api-Key": BICSCAN_API_KEY,
      }
      url = urljoin(BICSCAN_API_BASE, endpoint)
  
      async with httpx.AsyncClient() as client:
          try:
              logger.info(f"Making request to {url}")
              logger.debug(f"{headers=} {data=}")
              response = await client.post(url, headers=headers, json=data, timeout=30)
              response.raise_for_status()
              logger.info(f"Received response: {response.status_code}")
              return response.json()
          except httpx.HTTPStatusError as http_err:
              logger.error(f"Received response: {http_err}, {response.text}")
              return response.json()
          except Exception as e:
              logger.exception(f"Received response: {e}, {response.text}")
              return {}