Bicscan Mcp Server

What is Bicscan Mcp Server about?

Bicscan Mcp Server offers an API that evaluates the risk level of blockchain entities such as cryptocurrency addresses, domain names, and dApp URLs. It returns a risk score (0‑100) where a higher number indicates greater risk, and can also return detailed asset holdings for those entities.

How to use Bicscan Mcp Server?

1. Clone the repository

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

2. Choose an execution method – uv, docker, or uvx.
   • uv: Install Python 3.10+, uv 0.6.x, then run the server with the uv command as configured in claude_desktop_config.json.
   • Docker: Build the image with make and run it via Docker.
   • uvx: Execute directly from the Git repository using uvx.
3. Set the BICSCAN_API_KEY environment variable (obtain a free key from https://bicscan.io) in the configuration JSON.
4. Add the MCP server entry to claude_desktop_config.json under mcpServers.

Key features of Bicscan Mcp Server

• Risk Scoring: Scores from 0‑100 for crypto addresses, domains, and dApp URLs.
• Asset Information: Returns holdings of cryptocurrencies and tokens across multiple blockchains.
• Real‑time Scanning: Leverages the BICScan API for up‑to‑date data.
• Multiple Deployment Options: Supports uv, Docker, and uvx.
• Secure & Reliable: Built‑in error handling and logging.

Use cases of Bicscan Mcp Server

• Compliance & AML: Assess the risk of wallet addresses before transactions.
• DApp Security: Scan URLs and domains for malicious activity.
• Portfolio Monitoring: Retrieve current asset holdings for reporting tools.
• Threat Intelligence: Feed risk scores into security dashboards.
• Developer Integration: Embed risk checks directly into blockchain apps.

FAQ from the Bicscan Mcp Server

Q: What blockchains are supported? A: Any blockchain that BICScan indexes; the API returns network‑specific asset data.

Q: Is there a free tier? A: Yes, BICScan offers a free API key with limited daily requests.

Q: Can I run the server locally without Docker? A: Absolutely – use the uv or uvx methods on a Python 3.10+ environment.

Q: How do I update the API key? A: Edit the BICSCAN_API_KEY value in claude_desktop_config.json and restart the server.

Q: What response format does the server use? A: JSON payloads containing risk_score, risk_details, and asset_holdings fields.

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)

{
  "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

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)

{
  "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

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)

{
  "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?

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.