get_risk_score
Assess risk for blockchain addresses, domains, and hostnames by retrieving a security score from 0 to 100 to identify potential threats.
Instructions
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.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes |
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 {}