enterprise_get_keyword_searchLABSCO SUMMARY
Every detail lookup is a two-step: the tools that return real depth only accept a company's exact registered name.
Five of the six tools key off the full registered name, and the documented path is to run the keyword search first and feed it the name that comes back — plan for two calls, not one. Search results page at 50 rows at a time. The same registration also gives you two ways in, environment variables for the local process or a token in the URL for the hosted endpoint, so you can try the data before installing anything.
What it is
Handaas Enterprise Data puts the Handaas company database behind six MCP tools. You search by keyword — a company name, a person, a brand, a product, a job title — and get back matching firms with address, legal representative, registered capital, founding date and operating status. With a company's full registered name you can then ask for its registration record and description, its controlling shareholders, its outbound investments, its branches, or its senior people. It runs as a local Python process over stdio, SSE or streamable-http, or you can point your client at the vendor's hosted endpoint instead.
What you get
- enterprise_get_keyword_search does fuzzy matching across company names, people, brands, products and job titles, returning each hit with its address, enterprise type, legal representative, founding date, homepage, operating status, registered capital and annual turnover.
- enterprise_get_enterprise_base_info takes a company's full name and returns its registration record, a written description, its business lines and its tags — the one to reach for when the question is simply what this company does.
- enterprise_get_enterprise_holder_info returns the controlling shareholders with entity type, shareholder type, stake ratio, paid-in amount and subscription detail, plus a separate list drawn from listed-company disclosures.
- enterprise_get_enterprise_invest_info lists the companies a firm has invested in, each with stake ratio, investment amount, registered capital, business scope, region, founding date, listing status and legal representative.
- enterprise_get_enterprise_branch_info returns registered branches with address, founding date, legal representative, operating status, registration authority, organisation code and unified social credit code.
- enterprise_get_enterprise_main_person_info returns the senior people with their position, shareholding ratio, and how many companies they currently hold posts at or have held posts at.
Requirements
An account on handaas.com — you register there for the integrator and secret values, or for the token used by the hosted route. Run locally, it is a Python 3.10+ process: clone the repo, install the requirements into a virtual environment, and supply INTEGRATOR_ID, SECRET_ID and SECRET_KEY through the environment or your client's config. It starts over stdio, SSE or streamable-http, and the HTTP mode listens on port 8000. The vendor also runs a hosted endpoint at mcp.handaas.com that takes the same registration's token in the URL and needs nothing installed.
Setup effort
Build from source — clone the repository, then follow the project's own run instructions
USE CASES
01
Someone mentioned a company and I only half caught the name
Fuzzy-search the fragment and get back candidate firms with enough registration detail to tell which one they meant.
02
Work out what a prospect actually sells before the call
Resolve the name, then pull the registration record, description, business lines and tags in one step.
03
Find out who really controls a supplier before we sign
Resolve the supplier's full name, then read the shareholder list with stake ratios and paid-in amounts.
04
Map a group's subsidiaries and where it has put money
Pull the outbound investments with stake ratios and amounts, and the registered branches with their addresses.
05
Work out who to approach at a target account
List the senior people with their positions, shareholdings and how many other companies they sit at.
06
Check whether a company is still trading, and from where
Read the operating status on the registration record and cross-check it against the branches still on file.
6 tools
Listed in project docs. Your client may show a different list.
enterprise_get_enterprise_base_infoenterprise_get_enterprise_holder_infoenterprise_get_enterprise_invest_infoenterprise_get_enterprise_branch_infoenterprise_get_enterprise_main_person_infoBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation. Five tools need a company's full registered name; run enterprise_get_keyword_search first to get it.
Requires
uv on PATH; Python 3.10+; INTEGRATOR_ID, SECRET_ID and SECRET_KEY from handaas.com; INTEGRATOR_ID in your environment; SECRET_ID in your environment; SECRET_KEY in your environment
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
uv
TERMINAL
uv run mcp run {workdir}/server/mcp_server.py{workdir} is the vendor's own placeholder for your checkout — the command does not run until you replace it, and the virtualenv it points at has to exist first.
Hosted endpoint
ENDPOINT URL
https://mcp.handaas.com/enterprise/enterprise_profile?token={token}Connect a client to this instead of installing anything, with the credentials under Requirements. Replace {token} in the address with your own token. Taken from this project's own documentation.
MCP Clients
Cursor, Cherry Studio
JSON
{
"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"
}
}
}
}
