What is BICScan MCP Server

BICScan MCP Server is a robust API that provides risk scoring and asset information for blockchain addresses, domains, and decentralized applications. It utilizes the BICScan API to deliver real-time risk assessments, helping users identify potentially risky blockchain entities.

Use cases

Ideal for blockchain analysts, security researchers, and developers looking to evaluate the risk associated with cryptocurrency addresses and applications. It can be used for compliance checks, fraud detection, and enhancing the security of digital assets by obtaining detailed risk scores and asset holdings.

How to use

Users can run the BICScan MCP Server using Python with ‘uv’, Docker, or ‘uvx’. After cloning the repository, they should configure the ‘claude_desktop_config.json’ file to include their local repository path and the BICScan API key. Detailed instructions are provided for each method of installation and execution.

Key features

The server offers comprehensive risk scoring (0 to 100 scale), asset information retrieval across multiple blockchain networks, real-time scanning for potential risks, and a secure, reliable operation with robust error handling and logging.

Where to use

BICScan MCP Server can be integrated into compliance tools, cryptocurrency exchanges, wallets, and analytic platforms that require real-time risk assessment of blockchain addresses and applications, making it essential for enhancing security protocols in the cryptocurrency ecosystem.

BICScan MCP Server

A powerful and efficient Blockchain address risk scoring API MCP Server, leveraging the BICScan API to provide comprehensive risk assessments and asset information for blockchain addresses, domains, and decentralized applications (dApps).

🎉 We’re listed on https://github.com/modelcontextprotocol/servers for official integration 🎉

https://github.com/user-attachments/assets/f9425429-1cb1-4508-b962-81351075258b

Key Features

• Risk Scoring: Obtain risk scores for various blockchain entities, including crypto addresses, domain names, and decentralized application URLs, with scores ranging from 0 to 100, where 100 indicates high risk.
• Asset Information: Retrieve detailed asset holdings for specified crypto addresses, including cryptocurrencies and tokens, with support for multiple blockchain networks.
• Real-time Scanning: Utilize the BICScan API to perform real-time scans and receive up-to-date information on potential risks and asset holdings.
• Secure and Reliable: Built with robust error handling and logging to ensure secure and reliable operations.

Example Output

How to use.

You con either use Python with uv or docker depending on your preference.

Depending on your environment, you can choose to use either uv, docker, or uvx.

1. Running with uv

1-1. Requirements

1. Python 3.10 or higher
2. uv 0.6.x
3. git

1.2. Clone the repository

git clone https://github.com/ahnlabio/bicscan-mcp

1.3. Config claude_desktop_config.json

Append following to claude_desktop_config.json.

Make sure to replace:

• YOUR_BICSCAN_REPO_DIR_HERE: to something like C:\\Users\\ABC\\repo\\bicscan-mcp or /home/abc/repo/bicscan-mcp similarly.
• YOUR_BICSCAN_API_KEY_HERE: to free API key can be obtained from https://bicscan.io (details below)

2. Running with Docker

2.1. Requirements

1. Docker environment

2.2. Clone the repository

git clone https://github.com/ahnlabio/bicscan-mcp

2.3. Build Docker image.

Just run make in the repository directory to build docker image.

2.4. Config

Append following to claude_desktop_config.json

Make sure to replace:

• YOUR_BICSCAN_API_KEY_HERE to API key obtained from https://bicscan.io (details below)

3. Running with uvx

3.1. Requirements

1. Python 3.10 or higher
2. uv 0.6.x
3. git

3.2. Config claude_desktop_config.json

Append following to claude_desktop_config.json.

Make sure to replace:

• YOUR_BICSCAN_API_KEY_HERE: to free API key can be obtained from https://bicscan.io (details below)

How to obtain Free BICScan API Key?

1. Visit https://bicscan.io and register.
2. Go to profile and create “Create App”
3. Enter name and description on your choice.
4. Replace YOUR_BICSCAN_API_KEY_HERE part from above config to your newly obtained key.
5. restart the Claude Desktop.