BICScan Mcp Server

What is BICScan Mcp Server about?

BICScan Mcp Server offers an API that evaluates the risk level of various blockchain entities—crypto addresses, domains, and dApp URLs—and retrieves comprehensive asset information across multiple chains.

How to use BICScan Mcp Server?

Clone the repository

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

Choose an execution method:
- uv (Python 3.10+, uv 0.6.x): run uv run bicscan-mcp after setting the environment variable BICSCAN_API_KEY.
- Docker: build the image with make then start the container using the provided Docker command.
- uvx: execute directly from the Git URL with uvx --from git+https://github.com/ahnlabio/bicscan-mcp bicscan-mcp.
Configure claude_desktop_config.json by adding a bicscan entry under mcpServers with the appropriate command, arguments, and the BICSCAN_API_KEY you obtain from https://bicscan.io.

Key features of BICScan Mcp Server

Risk Scoring: Scores 0‑100, where 100 indicates high risk, for crypto wallets, domains, and dApp URLs.
Asset Information: Returns balances of native coins and tokens on supported blockchains.
Real‑time Scanning: Queries the live BICScan API for up‑to‑date data.
Multi‑chain Support: Works across several blockchain networks.
Robust Error Handling & Logging: Ensures reliable operation in production environments.

Use cases of BICScan Mcp Server

Compliance & AML: Flag high‑risk addresses before processing transactions.
Wallet & Exchange Security: Continuously monitor user wallets for emerging threats.
dApp Reputation Management: Assess the safety of decentralized applications before integration.
Threat Intelligence Platforms: Enrich security feeds with blockchain‑specific risk data.
Financial Analytics: Combine risk scores with asset holdings for risk‑adjusted reporting.

FAQ from the BICScan Mcp Server

Q: Which programming languages are supported? A: The server runs on Python (≥3.10) and can be executed via uv, Docker, or uvx. Clients can call the HTTP API from any language.

Q: How do I obtain an API key? A: Register at https://bicscan.io, create an app in your profile, and copy the generated key into the BICSCAN_API_KEY environment variable.

Q: Can I run the server locally without Docker? A: Yes, install uv, set the API key, and run uv run bicscan-mcp from the cloned repository.

Q: What blockchains are covered? A: The server supports all networks that BICScan provides data for; check the BICScan documentation for the exact list.

Q: How is risk calculated? A: BICScan aggregates on‑chain activity, known scams, and address reputation to compute a 0‑100 risk score.

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

Python 3.10 or higher
uv 0.6.x
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)

{
  "mcpServers": {
    ... some other mcp servers ...,
    "bicscan": {
      "command": "uv",
      "args": [
        "--directory",
        "YOUR_BICSCAN_REPO_DIR_HERE",
        "run",
        "bicscan-mcp"
      ],
      "env": {
        "BICSCAN_API_KEY": "YOUR_BICSCAN_API_KEY_HERE"
      }
    }
  }
}

2. Running with `Docker`

2.1. Requirements

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)

{
  "mcpServers": {
    ... some other mcp servers ...,
    "bicscan": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--interactive",
        "--env", "BICSCAN_API_KEY=YOUR_BICSCAN_API_KEY_HERE",
        "bicscan-mcp"
      ]
    }
  }
}

3. Running with `uvx`

3.1. Requirements

Python 3.10 or higher
uv 0.6.x
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)

{
  "mcpServers": {
    ... some other mcp servers ...,
    "bicscan": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ahnlabio/bicscan-mcp",
        "bicscan-mcp"
      ],
      "env": {
        "BICSCAN_API_KEY": "YOUR_BICSCAN_API_KEY_HERE"
      }
    }
  }
}

How to obtain Free BICScan API Key?

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

BICScan Mcp Server