Content
# Tool List
[This MCP service provides comprehensive enterprise qualification certificate information query functions, including honorary qualifications, enterprise qualifications, administrative licenses, and qualification certificate profiles, helping users understand the enterprise's qualification background and professional capabilities.](https://www.handaas.com/)
## Main Functions
- 🔍 Enterprise keyword fuzzy search
- 🏆 Honorary qualifications query
- 📋 Enterprise qualifications information query
- 📜 Administrative license information query
- 📊 Qualification certificate profile statistics
## Environmental Requirements
- Python 3.10+
- Dependencies: python-dotenv, requests, mcp
## Local Quick Start
### 1. Clone Project
```bash
git clone https://github.com/handaas/qualification-mcp-server
cd qualification-mcp-server
```
### 2. Create Virtual Environment & Install Dependencies
```bash
python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt
```
### 3. Environment Configuration
Copy environment variable template and configure:
```bash
cp .env.example .env
```
Edit `.env` file and configure the following environment variables:
```env
INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
```
### 4. Start Service with streamable-http
```bash
python server/mcp_server.py streamable-http
```
The service will start at `http://localhost:8000`.
#### Support startup methods: stdio or sse or streamable-http
### 5. Cursor / Cherry Studio MCP Configuration
```json
{
"mcpServers": {
"handaas-mcp-server": {
"type": "streamableHttp",
"url": "http://127.0.0.1:8000/mcp"
}
}
}
```
## STDIO Version Installation and Deployment
### Set Cursor / Cherry Studio MCP Configuration
```json
{
"mcpServers": {
"qualification-mcp-server": {
"command": "uv",
"args": ["run", "mcp", "run", "{workdir}/server/mcp_server.py"],
"env": {
"PATH": "{workdir}/mcp_env/bin:$PATH",
"PYTHONPATH": "{workdir}/mcp_env",
"INTEGRATOR_ID": "your_integrator_id",
"SECRET_ID": "your_secret_id",
"SECRET_KEY": "your_secret_key"
}
}
}
}
```
## Use Official Remote Service
### 1. Directly Set Cursor / Cherry Studio MCP Configuration
```json
{
"mcpServers": {
"qualification-mcp-server":{
"type": "streamableHttp",
"url": "https://mcp.handaas.com/bidding/bidding_bigdata?token={token}"
}
}
}
```
### Note: integrator_id, secret_id, secret_key, and token need to be registered and opened on https://www.handaas.com/ to obtain platform access.
## Available Tools
### 1. qualification_bigdata_fuzzy_search
**Function**: Enterprise keyword fuzzy query
Fuzzy query related enterprise list based on provided enterprise name, person name, brand, product, position and other keywords.
**Parameters**:
- `matchKeyword` (required): Matching keyword
- `pageIndex` (optional): Pagination start position
- `pageSize` (optional): Pagination end position
**Return Value**:
- `total`: Total number
### 2. qualification_bigdata_honor_qualifications
**Function**: Honorary qualifications query
Query and return enterprise honorary qualification details, including recognition authority, qualification level, validity period, etc., based on input enterprise related information.
**Parameters**:
- `matchKeyword` (required): Enterprise name / registration number / unified social credit code / enterprise id
- `keywordType` (optional): Subject type enumeration
**Return Value**:
- `total`: Total number
- `resultList`: Honorary qualification list
- `eaqBeginDate`: Validity period start date
- `eaqPublishDate`: Publish date
- `eaqRecognitionLevel`: Qualification level
- `eaqTitle`: Announcement title
- `eaqEndDate`: Validity period end date
- `eaqType`: Qualification type
- `eaqAuthority`: Recognition authority
### 3. qualification_bigdata_enterprise_qualifications
**Function**: Enterprise qualification information query
Query and return enterprise qualification information, including total qualification number, qualification information list, enterprise qualification classification, qualification type and other multi-dimensional data.
**Parameters**:
- `matchKeyword` (required): Enterprise name / registration number / unified social credit code / enterprise id
- `keywordType` (optional): Subject type enumeration
- `pageIndex` (optional): Page number
- `pageSize` (optional): Pagination size - up to 10 data per page
**Return Value**:
- `total`: Total qualification number
- `resultList`: Qualification information list
- `qualificationClasses`: Enterprise qualification classification (1: Enterprise innovation and growth class, 2: Technology research and development and innovation class, 3: Technology service and incubation class, 4: Intellectual property class, 5: Industry upgrading and transformation class)
- `qualificationType`: Qualification type
- `publishYear`: Publish year
- `publishDate`: Publish date
- `qualificationLevel`: Qualification level
- `agency`: Publish unit
- `highTechIndustryList`: High-tech industry classification
- `greenProducts`: Green design products
### 4. qualification_bigdata_administrative_licenses
**Function**: Administrative license information query
Query and return enterprise administrative license information, including license details and validity period, based on provided enterprise identification information.
**Parameters**:
- `matchKeyword` (required): Enterprise name / registration number / unified social credit code / enterprise id
- `pageSize` (optional): Pagination size - up to 50 data per page
- `pageIndex` (optional): Page number
- `keywordType` (optional): Subject type enumeration
**Return Value**:
- `total`: Total number
- `resultList`: Administrative license list
- `authority`: License authority
- `auditType`: Audit type
- `beginDate`: License validity period from
- `content`: License content
- `status`: Current status
- `endDate`: License validity period to
- `creditPubLicenseId`: Administrative license decision document number
- `fileName`: Administrative license decision document name
### 5. qualification_bigdata_qualification_certificate_profile
**Function**: Qualification certificate profile statistics
Query enterprise qualification certificate profile based on enterprise basic information, including total certificate number, certificate time analysis, etc.
**Parameters**:
- `matchKeyword` (required): Enterprise name / registration number / unified social credit code / enterprise id
- `keywordType` (optional): Subject type enumeration
**Return Value**:
- `certificateCount`: Certificate number
- `certNumberThisYear`: Number of certificates obtained this year
- `certFirstPublishTime`: Initial certificate publish time
- `certTypeList`: Covered certificate categories
- `certLastPublishTime`: Recent certificate publish time
## Usage Scenarios
1. **Qualification Verification**: Enterprises, investors, partners, or regulatory agencies quickly obtain enterprise qualification background.
2. **Bidding and Quotation Review**: Enterprises verify qualifications when participating in project bidding to ensure compliance with requirements.
3. **Cooperation Assessment**: Partners verify enterprise qualification authenticity and assess cooperation risks.
4. **Compliance Inspection**: Government departments conduct enterprise compliance inspections and industry qualification supervision.
5. **Financial Approval**: Financial institutions conduct background investigations during loan approvals.
6. **Market Research**: Understand enterprise qualification distribution and trends within the industry.
## Precautions for Use
1. **Enterprise Full Name Requirement**: When calling interfaces that require enterprise full name, if there is no enterprise full name, call qualification_bigdata_fuzzy_search interface to obtain enterprise full name first.
2. **Pagination Limitation**: Different interfaces have different pagination limitations. Enterprise qualification query has a maximum of 10 data per page, and administrative license query has a maximum of 50 data per page.
3. **Validity Period Attention**: Pay attention to qualification and license validity periods to ensure timeliness.
4. **Qualification Classification**: Enterprise qualifications are divided into 5 main categories for classification management and query.
5. **Data Timeliness**: Qualification information is regularly updated. It is recommended to pay attention to the latest certificate issuance dates.
## Example Questions
### qualification_bigdata_honor_qualifications (Honorary Qualifications Query)
3. What honorary qualifications has Tencent obtained? What are the recognition authorities?
4. What are the honorary qualification levels of Alibaba? What are the validity periods?
5. How many honorary qualifications does Huawei have? What are the main types?
### qualification_bigdata_enterprise_qualifications (Enterprise Qualification Information Query)
6. How many enterprise qualifications does Baidu have in total? What are the main categories?
7. What are the technology research and development qualifications of Tencent? What are the levels?
8. What is the situation of Douyin's high-tech enterprise qualifications?
### qualification_bigdata_administrative_licenses (Administrative License Information Query)
9. What administrative licenses does Alibaba have? Who are the license authorities?
10. What are the validity periods of Huawei's administrative licenses?
11. What are the administrative license decision documents of Tencent?
### qualification_bigdata_qualification_certificate_profile (Qualification Certificate Profile Statistics)
12. How many qualification certificates does Baidu have in total? How many were added this year?
13. When did Alibaba initially obtain certificates? What certificate categories are covered?
14. When was Huawei's recent certificate issuance date? What is the trend of certificate numbers?
