Qualification

This MCP server provides a comprehensive set of tools to query enterprise qualification information, including honors, enterprise qualifications, administrative licenses, and certificate profiles. It helps you quickly verify a company’s credentials, validate partnerships, and assess compliance for bids, financings, and market research.

How to use

You connect a client to this MCP server to search and retrieve structured qualification data. Use the available endpoints to perform fuzzy searches for enterprises, fetch honor qualifications, retrieve enterprise qualification details, query administrative licenses, and obtain certificate profile statistics. You can integrate these capabilities into your bid reviews, supplier onboarding, risk assessments, and regulatory checks.

How to install

Prerequisites: Python 3.10 or newer is required.

1. Clone the project.

git clone https://github.com/handaas/qualification-mcp-server
cd qualification-mcp-server

2. Create a virtual environment and install dependencies.

python -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt

3. Configure environment variables.

cp .env.example .env

Then edit your new .env file to include your credentials like this:

INTEGRATOR_ID=your_integrator_id SECRET_ID=your_secret_id SECRET_KEY=your_secret_key

4. Start the MCP server in streamable-http mode.

python server/mcp_server.py streamable-http

The service will be available at http://localhost:8000/mcp. You can also run the server in other modes if you prefer stdio or SSE, as described later.

## Additional configuration examples

If you want to connect a client through Cursor or Cherry Studio, you can use the following configuration snippet.

{ "mcpServers": { "handaas-mcp-server": { "type": "streamableHttp", "url": "http://127.0.0.1:8000/mcp" } } }

## Using official Remote service

If you prefer to use the official remote MCP endpoint, configure your client as shown here. You will need to log in to obtain integrator and token details.

{ "mcpServers": { "qualification-mcp-server":{ "type": "streamableHttp", "url": "https://mcp.handaas.com/bidding/bidding_bigdata?token={token}"
} } }

## Security and environment notes

Keep your integrator and secret keys secure. Do not commit secret credentials to version control. Use environment-specific configurations for development, staging, and production.

## Usage tips and limitations

- Some endpoints support pagination; enterprise qualifications are limited to 10 results per page, and administrative licenses up to 50 per page. Plan pagination accordingly.

- Always verify the validity period for qualifications and licenses to ensure timeliness in your checks.

## What you can query

You can use the following available tools to retrieve data. Each tool is described in detail under Tools.

## Available tools

### qualification\_bigdata\_fuzzy\_search

Performs fuzzy searches for enterprise keywords such as company names, personals, brands, products, or roles to return matching enterprises.

### qualification\_bigdata\_honor\_qualifications

Queries and returns honors qualifications for an enterprise, including issuing authority, level, and validity periods.

### qualification\_bigdata\_enterprise\_qualifications

Retrieves enterprise qualification information, including total count, categories, types, and related metadata.

### qualification\_bigdata\_administrative\_licenses

Returns administrative licenses for an enterprise, including license content and validity periods.

### qualification\_bigdata\_qualification\_certificate\_profile

Provides statistics on qualification certificates such as total certificates and timelines.