home / mcp / enterprise mcp server

Enterprise MCP Server

Provides enterprise data queries including basic info, holders, investments, branches, and major personnel with keyword search and detailed endpoints.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "handaas-enterprise-mcp-server": {
      "url": "http://127.0.0.1:8000/mcp",
      "headers": {
        "SECRET_ID": "YOUR_SECRET_ID",
        "SECRET_KEY": "YOUR_SECRET_KEY",
        "INTEGRATOR_ID": "YOUR_INTEGRATOR_ID"
      }
    }
  }
}

You have access to an MCP server that aggregates enterprise data such as basic company information, business scope, key personnel, and investment details. It enables quick, fuzzy searches and provides structured results you can use for analytics, dashboards, or downstream workflows.

How to use

To get started, connect your MCP client to one of the available endpoints and perform the six core operations: search by keywords, retrieve base company information, view holding information, check external investments, list branch offices, and fetch major personnel. Start with a keyword search to locate the company you have in mind, then drill down to the specific data you need using the related endpoints. For any enterprise full-name based queries, begin with a keyword search to locate the exact company entry before requesting full details.

How to install

Prerequisites: Python 3.10 or higher and the following dependencies must be installed: python-dotenv, requests, and mcp.

# 1. Clone the project
git clone https://github.com/handaas/enterprise-mcp-server
cd enterprise-mcp-server

# 2. Create a virtual environment and activate it
python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt

# 3. Configure environment variables
cp .env.example .env
# Edit .env and set:
# INTEGRATOR_ID=your_integrator_id
# SECRET_ID=your_secret_id
# SECRET_KEY=your_secret_key

# 4. Start the streamable-http MCP server
python server/mcp_server.py streamable-http

# The service will start at http://localhost:8000

Additional configuration

You can also connect through a Cherry Studio MCP configuration or use the official remote service. The following examples show how to configure HTTP-based MCP connections and a local stdio-based runtime. Use the presets exactly as shown to ensure compatibility.

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

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

If you prefer a local runtime, you can use the stdio-based configuration shown below. This runs the MCP server via the uv runtime and passes the Python script path and environment values as needed.

{
  "mcpServers": {
    "enterprise-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"
      }
    }
  }
}

Available tools

enterprise_get_keyword_search

Performs a fuzzy search over enterprises using keywords such as name, person, brand, product, or role to return a list of matching companies.

enterprise_get_enterprise_base_info

Retrieves the base information for a given enterprise full name to identify its business focus.

enterprise_get_enterprise_holder_info

Fetches holding shareholder information for a given enterprise, combining official工商公示 data with extended datasets.

enterprise_get_enterprise_invest_info

Returns external investment information for a given enterprise, including investee details and ownership ratios.

enterprise_get_enterprise_branch_info

Provides branch office information for a given enterprise, sourced from工商公示 data.

enterprise_get_enterprise_main_person_info

Lists major personnel for a given enterprise, including names, positions, and shareholdings.