BICScan MCP Server

1# BICScan MCP Server
2A 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).
3
4## Key Features
5- **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.
6- **Asset Information**: Retrieve detailed asset holdings for specified crypto addresses, including cryptocurrencies and tokens, with support for multiple blockchain networks.
7- **Real-time Scanning**: Utilize the BICScan API to perform real-time scans and receive up-to-date information on potential risks and asset holdings.
8- **Secure and Reliable**: Built with robust error handling and logging to ensure secure and reliable operations.
9
10## Example Output
11
12## How to use.
13
14You con either use Python with `uv` or `docker` depending on your preference.
15
16Depending on your environment, you can choose to use either `uv`, `docker`, or `uvx`.
17
18### 1. Running with `uv`
19
20#### 1-1. Requirements
211. Python 3.10 or higher
222. uv 0.6.x
233. git
24
25#### 1.2. Clone the repository
26```sh
27git clone https://github.com/ahnlabio/bicscan-mcp
28```
29
30#### 1.3. Config `claude_desktop_config.json`
31
32Append following to `claude_desktop_config.json`.
33
34Make sure to replace:
35 - `YOUR_BICSCAN_REPO_DIR_HERE`: to something like `C:\\Users\\ABC\\repo\\bicscan-mcp` or `/home/abc/repo/bicscan-mcp` similarly.
36 - `YOUR_BICSCAN_API_KEY_HERE`: to free API key can be obtained from https://bicscan.io (details below)
37
38```json
39{
40  "mcpServers": {
41    ... some other mcp servers ...,
42    "bicscan": {
43      "command": "uv",
44      "args": [
45        "--directory",
46        "YOUR_BICSCAN_REPO_DIR_HERE",
47        "run",
48        "bicscan-mcp"
49      ],
50      "env": {
51        "BICSCAN_API_KEY": "YOUR_BICSCAN_API_KEY_HERE"
52      }
53    }
54  }
55}
56```
57
58
59### 2. Running with `Docker`
60
61#### 2.1. Requirements
621. Docker environment
63
64
65#### 2.2. Clone the repository
66```sh
67git clone https://github.com/ahnlabio/bicscan-mcp
68```
69
70#### 2.3. Build Docker image.
71
72Just run `make` in the repository directory to build docker image.
73
74
75#### 2.4. Config
76Append following to `claude_desktop_config.json`
77
78Make sure to replace:
79 - `YOUR_BICSCAN_API_KEY_HERE` to API key obtained from https://bicscan.io (details below)
80
81```json
82{
83  "mcpServers": {
84    ... some other mcp servers ...,
85    "bicscan": {
86      "command": "docker",
87      "args": [
88        "run",
89        "--rm",
90        "--interactive",
91        "--env", "BICSCAN_API_KEY=YOUR_BICSCAN_API_KEY_HERE",
92        "bicscan-mcp"
93      ]
94    }
95  }
96}
97```
98
99### 3. Running with `uvx`
100
101#### 3.1. Requirements
1021. Python 3.10 or higher
1032. uv 0.6.x
1043. git
105
106#### 3.2. Config `claude_desktop_config.json`
107
108Append following to `claude_desktop_config.json`.
109
110Make sure to replace:
111 - `YOUR_BICSCAN_API_KEY_HERE`: to free API key can be obtained from https://bicscan.io (details below)
112
113```json
114{
115  "mcpServers": {
116    ... some other mcp servers ...,
117    "bicscan": {
118      "command": "uvx",
119      "args": [
120        "--from",
121        "git+https://github.com/ahnlabio/bicscan-mcp",
122        "bicscan-mcp"
123      ],
124      "env": {
125        "BICSCAN_API_KEY": "YOUR_BICSCAN_API_KEY_HERE"
126      }
127    }
128  }
129}
130```
131
132
133
134## How to obtain Free BICScan API Key?
135
1361. Visit `https://bicscan.io` and register.
1372. Go to profile and create "Create App"
1383. Enter name and description on your choice.
1394. Replace `YOUR_BICSCAN_API_KEY_HERE` part from above config to your newly obtained key.
1405. restart the Claude Desktop.