cisp-mcp
This server provides MCP tools to query Chinese enterprise information via the CISP API. Each CISP product interface is exposed as an independent tool, with automatic prodCode handling and unified normalization of results.
Business Registration & Profile
p0010010_query_business_profile: Query basic enterprise registration info by company name, unified social credit code, or registration number.p0010058_query_business_basic_deep: Retrieve detailed enterprise registration info using company name, credit code, registration number, or organization code.p0010068_fuzzy_search_company_name: Search for companies by keyword/partial name.
Intellectual Property
p0010073_query_trademark_info: Look up trademark registrations for an enterprise.p0010074_query_software_copyright_info: Retrieve software copyright records.p0010075_query_work_copyright_info: Look up artistic/literary work copyright registrations.p0010078_query_patent_info: Search patents by enterprise, with date range and type filters.
Online Presence
p0010076_query_icp_filing_info: Look up ICP website filing records for an enterprise.
Licenses & Qualifications
p0010084_query_license_info: Query enterprise licenses.p0110003_query_honor_qualification_info: Look up awards, certifications, and qualifications.
Related Party Information
p0020021_query_single_point_related_info: Retrieve investment and executive appointment relationships.
Public Opinion
p0050007_query_public_opinion_list: Retrieve a paginated list of news/media mentions for an enterprise.p0050008_query_public_opinion_detail: Fetch detailed content of a specific public opinion entry.p0050007_p0050008_query_public_opinion_info: Automatically fetch the opinion list then retrieve full details for each entry in one call.
Enterprise Verification
p0060007_verify_business_two_elements: Verify that an enterprise name matches a given registration number.p0060008_verify_business_three_elements: Verify enterprise name, registration number, and legal representative name all match.
Generic / Debug
query_cisp_product: A catch-all tool to query any CISP product endpoint by providing a product code directly, useful for debugging or accessing products without dedicated tools.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cisp-mcp查询证通股份有限公司的工商照面信息"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
cisp-mcp
cisp-mcp 是一个用 Python 编写的 CISP API MCP 服务,用于把 CISP 企业信息接口封装成可被大模型调用的 MCP tools。
项目使用 uv 管理依赖,基于 mcp Python SDK 的 FastMCP 开发,通过 CISP AI 网关 JSON 接口访问后端 API。
项目能力
支持 Claude Code、Codex、Codex App、OpenClaw、WorkBuddy 等 MCP 客户端接入。
每个 CISP 产品接口对应一个独立 MCP tool,工具名包含产品号,方便排查和定位。
自动补充
prodCode,调用方只需要传业务参数。对 CISP 返回结果做统一归一化,保留原始返回
raw_response。Streamable HTTP 模式支持每个客户使用自己的 CISP API Key,便于后端按 Key 计费。
支持本地 smoke test,验证 MCP 服务和工具注册是否正常。
Related MCP server: filed-mcp-server
技术栈
Python
>=3.11uv
MCP Python SDK / FastMCP
httpx
python-dotenv
运行环境要求
推荐本机提前安装:
Python
3.11或更高版本uv
uv 可以管理 Python 版本;如果本机没有符合要求的 Python,uv 在部分环境下可以自动下载和管理。但在企业内网、代理或离线环境中,自动下载可能失败,因此建议提前安装好 Python 3.11+。
生产部署
CentOS 7 联网构建、离线包制作、生产部署、升级、回滚和新增依赖的完整流程,请参阅:
项目结构
cisp-mcp/
├── src/cisp_mcp/
│ ├── server.py # MCP tool 定义和服务入口
│ ├── client.py # CISP JSON 网关客户端
│ ├── config.py # 环境变量配置
│ └── interfaces.py # 产品码、接口名称、状态码等定义
├── scripts/
│ └── smoke_test_mcp.py
├── docs/ # 本地接口文档目录
├── .env.example
├── pyproject.toml
└── README.md快速开始
1. 下载项目
git clone <your-github-repo-url>
cd cisp-mcp如果是在已有目录:
cd /path/to/cisp-mcp2. 检查 Python 和 uv
检查 Python:
python3 --version检查 uv:
uv --version如果没有安装 uv,可以按 uv 官方方式安装,或使用本机已有的 Python 环境安装。
3. 安装依赖
uv sync4. 配置环境变量(本地 stdio 模式)
复制模板:
cp .env.example .env编辑 .env:
CISP_ENDPOINT=https://cisp.zenitera.com
CISP_REQUEST_URI=/ectcispserver/api/entcreditapi/query
# 可选;配置后仅 CISP 出站请求使用该代理
# CISP_ENDPOINT_PROXY=http://proxy.example.internal:8080
CISP_API_KEY=替换成真实 API Key
CISP_TIMEOUT_SECONDS=30
CISP_VERIFY_SSL=trueCISP_API_KEY 只用于本地 stdio 模式。生产 Streamable HTTP 模式不在服务器保存统一 Key,而是要求每个客户发送:
Authorization: Bearer <客户自己的CISP_API_KEY>服务会将当前请求的 Bearer Token转换为调用 CISP 后台所需的:
X-API-Key: <客户自己的CISP_API_KEY>如果访问 CISP_ENDPOINT 必须经过代理,配置:
CISP_ENDPOINT_PROXY=http://proxy.example.internal:8080也支持 socks5:// 代理。未配置或配置为空时,CISP 请求直接连接目标地址;程序不会继承系统的 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY,避免实际路由与配置不一致。
本地运行和调试
smoke test
这个测试验证 MCP 服务能否启动、无 Bearer Key是否返回 401、不同客户能否隔离 MCP Session,以及 tools/list 是否能看到所有工具。它不会调用真实 CISP API,也不会消耗接口次数。
uv run python scripts/smoke_test_mcp.py正常结果类似:
Discovered MCP tools:
- p0010010_query_business_profile
- p0010058_query_business_basic_deep
...
- query_cisp_product
Total: 37
Smoke test passed.stdio 模式
stdio 是给 Claude Code、Codex、OpenClaw、WorkBuddy 等 MCP 客户端使用的模式。
uv run cisp-mcp手动执行时终端会停住,这是正常现象。stdio 模式通过标准输入/输出和 MCP 客户端通信,不会像 Web 服务一样打印访问地址。
HTTP 调试模式
如果要用 MCP Inspector 调试,可以启动 Streamable HTTP:
uv run cisp-mcp --transport streamable-http默认地址:
http://127.0.0.1:8000/mcp然后启动 Inspector:
npx -y @modelcontextprotocol/inspector在 Inspector 中选择:
Transport: Streamable HTTP
URL: http://127.0.0.1:8000/mcp
Authorization: Bearer <测试用CISP_API_KEY>工具列表
产品码 | 接口名称 | MCP tool |
| 企业工商照面信息查询 |
|
| 企业工商基本信息查询(深度) |
|
| 企业工商基本信息查询(简项) |
|
| 企业名称模糊查询(简版) |
|
| 企业商标信息查询 |
|
| 企业软件著作权信息查询 |
|
| 企业作品著作权信息查询 |
|
| 企业 ICP 备案信息查询 |
|
| 企业专利信息查询 |
|
| 企业许可信息查询 |
|
| 企业疑似关系信息查询 |
|
| 企业疑似实际控制人信息查询 |
|
| 企业单点关联信息查询 |
|
| 企业股权穿透信息查询 |
|
| 企业受益股东详细查询 |
|
| 企业多点关联信息查询 |
|
| 企业间关联关系查询 |
|
| 企业实控人和最终受益人查询 |
|
| 企业舆情信息列表查询 |
|
| 企业舆情信息详情查询 |
|
| 企业舆情信息查询(列表+详情) |
|
| 企业工商二要素验证 |
|
| 企业工商三要素验证 |
|
| 企业最终受益人信息查询(详版/非详版) |
|
| 企业实际控制人信息查询 |
|
| 企业最终受益人信息查询-全路径版 |
|
| 企业荣誉资质信息查询 |
|
| 企业关键指标信息查询 |
|
| 企业土地信息查询 |
|
| 企业画像-行业分析 |
|
| 上市公司财务数据查询 |
|
| 企业高级筛选 |
|
| 纳税评级 |
|
| 光大-近2年风险分析统计 |
|
| 上市投融资招投标知识产权情况 |
|
| 供应商关联关系 |
|
通用 | CISP JSON 网关调试查询 |
|
返回结构
专用工具会返回归一化字段和原始响应:
product_code:产品码interface_name:接口名称success:resultCode == "00000"has_result:产品状态码为4result_code_desc:结果码说明product_status_desc:产品状态说明data:产品数据对象raw_response:CISP 原始返回
如果产品数据里存在常用列表字段,也会额外透出快捷字段,例如:
basicListfuzzyListbrandListswListresultListicpListpatentsListdetailList(P0010084、P0130036)suspectListcontrolNodeListentInvListnodeList(P0020024)nodesrelationshipdataListfinalList(P0090001、P0090012)actualController(P0090008)MatchInfoListinfoListinfoDetailmatchListitemNameListcoreLndicatorInfo(P0130025,字段名沿用底层接口原始拼写)suppList(P0990022)entList(P0980006)list(P0980008、P0980023)data(P0980033)
P0210004 会根据 financial_type 在 data 中填充对应列表:
rgincomeInfo、rgcashflowInfo、fncmfninInfo、rgbalanceInfo、
mainfinadataInfo、balanceInfo、incomeInfo 或 cashflowInfo。
调用示例
查询工商照面信息
{
"ent_info": "证通股份有限公司"
}对应工具:
p0010010_query_business_profile查询深度工商信息
{
"ent_name": "证通股份有限公司"
}对应工具:
p0010058_query_business_basic_deep查询简项工商信息
ent_name、credit_code、reg_no、org_code 严格四选一;types 用于选择需要返回的数据类型。
{
"ent_name": "证通股份有限公司",
"types": ["basic", "person", "shareholder"]
}对应工具:
p0010059_query_business_basic_brief查询企业受益股东详细信息
ent_info 支持企业全称或统一社会信用代码。结果通过 nodeList 快捷字段返回;
benifitTag 是底层接口原始拼写,可包含“受益股东”“最终受益人”或“实际控制人”。
{
"ent_info": "证通股份有限公司"
}对应工具:
p0020024_query_beneficial_shareholders_detailed查询企业实际控制人
ent_name 支持企业全称、统一社会信用代码或工商注册号。结果通过
actualController 快捷字段返回,包含实际控制人、产品聚合股权占比和控制路径。
{
"ent_name": "证通股份有限公司"
}对应工具:
p0090008_query_actual_controller查询企业最终受益人(详版/非详版统一入口)
AI 应按任务目的选择 edition:完整报告、审计留档或关键管理人员兜底使用
detailed;快速识别、独立互证或需要 bnfCat 判定依据使用 standard。
非详版可将 include_paths 设为 false,只返回最终受益人。
{
"ent_name": "证通股份有限公司",
"edition": "detailed",
"include_paths": true
}对应工具:
p0090001_p0090012_query_ubo企业高级筛选
{
"eid": "可选的 CISP 企业内部标识",
"area_prefix": "44",
"org_scale": "大型",
"page_no": "1",
"page_size": "10"
}对应工具:
p0980006_query_advanced_company_filter查询上市、投融资、招投标和知识产权概况
{
"ent_info": "证通股份有限公司"
}对应工具:
p0980033_query_listing_financing_bidding_ipr查询纳税评级
eid 是 CISP 企业内部标识。如果只有企业名称,应先调用
p0010010_query_business_profile,从企业名称准确匹配的
basicList[].entId 获取,并将其作为 eid 传入。不要根据统一社会信用代码自行推算
eid。企业高级筛选查询成功时,也可以使用其返回的 entList[].eid。
{
"ent_info": "证通股份有限公司"
}{
"eid": "替换成 p0010010 返回的 basicList[].entId"
}对应工具:
p0980008_query_tax_rating查询近2年风险分析统计
如果只有企业名称,先调用 p0010010_query_business_profile,从企业名称准确匹配的
basicList[].entId 获取企业内部标识。不要自行构造或推算 eid。
{
"eid": "替换成 p0010010 返回的 basicList[].entId"
}对应工具:
p0980023_query_two_year_risk_summary查询专利信息
{
"ent_info": "证通股份有限公司",
"page_no": "1",
"page_size": "10"
}对应工具:
p0010078_query_patent_info查询企业投资和任职关联信息
用户只需要描述查询意图,模型会选择对应的 relation_direction:
"1":同时查询投资和任职关系"2":只查询投资关系"3":只查询任职关系
{
"ent_info": "证通股份有限公司",
"relation_direction": "2"
}对应工具:
p0020021_query_single_point_related_info查询企业荣誉资质
{
"ent_info": "证通股份有限公司"
}对应工具:
p0110003_query_honor_qualification_info查询企业关键指标
{
"ent_info": "证通股份有限公司",
"indicator_type": "2"
}indicator_type 可选值:
"1":指标等级,默认值"2":指标金额
结果列表通过 coreLndicatorInfo 快捷字段返回,包含报告年份、资产总额、负债总额、
所有者权益、营业收入、主营业务收入、利润、纳税、从业人数和社保人数等年报关键指标。
对应工具:
p0130025_query_company_key_indicators查询企业土地信息
{
"ent_info": "证通股份有限公司",
"land_type": "tddy",
"page_no": "1",
"page_size": "10"
}land_type 可选值:tdgy(土地供应)、tdcr(土地出让)、dkgs(地块公示)、tddy(土地抵押)。不传时由底层产品决定返回范围。
对应工具:
p0130036_query_land_info查询企业画像行业分析
{
"ent_info": "证通股份有限公司",
"analysis_type": "property",
"nic_lvl": "n3",
"region_lvl": "r2",
"region_id": "440300",
"nic_id": "C391"
}analysis_type 可选值:finRank、finRankStock、entRegionRank、locfin、indLocOpr、indLocOprFin、property、financialRegionRank。不同类型的结果字段不同,统一从返回的 data 中读取。
对应工具:
p0130038_query_industry_analysis查询上市公司财务数据
{
"ent_info": "证通股份有限公司",
"financial_type": "mainfinadata",
"start_date": "2024-01-01",
"end_date": "2025-12-31"
}financial_type 可选值:
rgincome:通用类利润rgcashflow:通用类现金流量fncmfnin:金融公司主要财务指标rgbalance:通用类资产负债mainfinadata:主要会计数据和财务指标balance:一般企业资产负债income:一般企业利润cashflow:一般企业现金流量
start_date、end_date 可选,格式为 YYYY-MM-DD。不同类型的结果列表位于
返回值的 data 对应 *Info 字段中。
对应工具:
p0210004_query_listed_company_financial_data查询供应商关联关系
{
"ent_info": "证通股份有限公司"
}对应工具:
p0990022_query_supplier_relationships查询企业许可
{
"ent_info": "证通股份有限公司",
"license_type": "ylxk",
"province": "广东省",
"page_no": "1",
"page_size": "10"
}对应工具:
p0010084_query_license_info查询企业舆情信息
{
"ent_name": ["证通股份有限公司", "水滴科技服务有限公司"],
"page_no": "1",
"page_size": "10",
"max_details": 10
}对应工具:
p0050007_p0050008_query_public_opinion_info说明:该工具会先调用 P0050007 查询舆情列表,再用列表返回的 entryId 和用户传入的 ent_name 调用 P0050008 查询舆情详情。
只查询企业舆情列表
{
"ent_name": ["证通股份有限公司", "水滴科技服务有限公司"],
"page_no": "1",
"page_size": "10"
}对应工具:
p0050007_query_public_opinion_list查询企业舆情详情
{
"entry_id": "替换成舆情列表返回的 entryId"
}对应工具:
p0050008_query_public_opinion_detail如果只传 ent_name,服务会先查询该企业第一页舆情列表,再取第一条 entryId 查询详情。
二要素验证
{
"ent_name": "证通股份有限公司",
"reg_no": "替换成真实统一社会信用代码"
}对应工具:
p0060007_verify_business_two_elements集成到 Claude Code
生产环境使用远程 Streamable HTTP。在启动 Claude Code 的环境中设置客户自己的 Key:
export CISP_API_KEY='<客户自己的CISP_API_KEY>'项目级 .mcp.json:
{
"mcpServers": {
"cisp-mcp": {
"type": "http",
"url": "https://mcp.example.com/mcp",
"headers": {
"Authorization": "Bearer ${CISP_API_KEY}"
}
}
}
}本地开发也可以使用 stdio 模式,让 Claude Code 自动启动 MCP 服务;此时 Key来自项目 .env:
claude mcp add --transport stdio --scope user cisp-mcp -- uv --directory /path/to/cisp-mcp run cisp-mcp检查配置:
claude mcp list
claude mcp get cisp-mcp进入 Claude Code 后输入:
/mcp看到 cisp-mcp connected 后即可使用。
示例问题:
查询一下证通股份有限公司的工商照面信息。
查询一下证通股份有限公司的专利信息。
帮我从工商信息、知识产权、网站备案几个角度快速了解证通股份有限公司。集成到 Codex CLI / Codex App
Codex CLI 和 Codex App 使用同一份 MCP 配置。生产远程服务配置如下:
[mcp_servers.cisp-mcp]
url = "https://mcp.example.com/mcp"
bearer_token_env_var = "CISP_API_KEY"
startup_timeout_sec = 20
tool_timeout_sec = 120
enabled = true启动 Codex 前设置:
export CISP_API_KEY='<客户自己的CISP_API_KEY>'本地开发可以使用 stdio 模式:
codex mcp add cisp-mcp -- uv --directory /path/to/cisp-mcp run cisp-mcp检查配置:
codex mcp list
codex mcp get cisp-mcp配置会写入:
~/.codex/config.toml对应的本地手动配置:
[mcp_servers.cisp-mcp]
command = "uv"
args = ["--directory", "/path/to/cisp-mcp", "run", "cisp-mcp"]
startup_timeout_sec = 20
tool_timeout_sec = 120
enabled = true配置后重新打开 Codex App,或新建一个 thread,在 Codex 中输入:
/mcp确认 cisp-mcp 已连接。
集成到 OpenClaw(小龙虾)
OpenClaw 可以通过 openclaw mcp set 保存 MCP Server 定义。推荐使用 stdio 模式,让 OpenClaw 在需要时启动 cisp-mcp。
本地项目方式
先确保项目目录下已经配置好 .env,然后执行:
openclaw mcp set cisp-mcp '{"command":"uv","args":["--directory","/path/to/cisp-mcp","run","cisp-mcp"]}'检查配置:
openclaw mcp list
openclaw mcp show cisp-mcp --json如果 OpenClaw Gateway 已经在运行,保存 MCP 配置后建议重启 Gateway 或新建会话:
openclaw gateway restart直接配置环境变量
如果不想依赖项目目录下的 .env,也可以把运行所需环境变量写入 OpenClaw MCP 配置:
openclaw mcp set cisp-mcp '{"command":"uv","args":["--directory","/path/to/cisp-mcp","run","cisp-mcp"],"env":{"CISP_ENDPOINT":"https://cisp.zenitera.com","CISP_REQUEST_URI":"/ectcispserver/api/entcreditapi/query","CISP_API_KEY":"填写自己的真实 API Key","CISP_TIMEOUT_SECONDS":"30","CISP_VERIFY_SSL":"true"}}'直接从 GitHub 运行
如果不想本地 clone 项目,可以使用 uvx 从 GitHub 运行:
openclaw mcp set cisp-mcp '{"command":"uvx","args":["--from","git+https://github.com/fw-magic/cisp-mcp.git","cisp-mcp"],"env":{"CISP_ENDPOINT":"https://cisp.zenitera.com","CISP_REQUEST_URI":"/ectcispserver/api/entcreditapi/query","CISP_API_KEY":"填写自己的真实 API Key","CISP_TIMEOUT_SECONDS":"30","CISP_VERIFY_SSL":"true"}}'配置完成后,可以在 OpenClaw 中直接提问:
查询一下证通股份有限公司的工商照面信息。
查询证通股份有限公司和水滴科技服务有限公司的舆情信息。集成到 WorkBuddy
生产环境进入“连接器 → 自定义连接器 → 配置 MCP”,填写:
{
"mcpServers": {
"cisp-mcp": {
"type": "streamable-http",
"url": "https://mcp.example.com/mcp",
"headers": {
"Authorization": "Bearer <客户自己的CISP_API_KEY>"
},
"disabled": false
}
}
}WorkBuddy 未明确支持环境变量展开时,应使用其凭据输入框或直接填写 Key,不要填写字面量 ${CISP_API_KEY}。
本地开发且 WorkBuddy 支持 stdio server 时,可以配置:
{
"mcpServers": {
"cisp-mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/cisp-mcp",
"run",
"cisp-mcp"
]
}
}
}本地 HTTP 调试可以先手动启动:
uv run cisp-mcp --transport streamable-http然后在 WorkBuddy 中配置 URL 和请求头:
URL: http://127.0.0.1:8000/mcp
Authorization: Bearer <客户自己的CISP_API_KEY>新增接口开发流程
后续如果要新增 CISP 产品接口:
把 PDF 接口文档放到本地
docs/目录。阅读基本信息、请求参数、返回字段和附录状态码。
在
src/cisp_mcp/interfaces.py中新增产品定义。在
src/cisp_mcp/server.py中新增一个@mcp.tool()。工具名格式建议为:
p产品号_英文语义名,例如p0010010_query_business_profile。更新
scripts/smoke_test_mcp.py的EXPECTED_TOOLS。运行 smoke test:
uv run python scripts/smoke_test_mcp.py常见问题
1. 手动运行 uv run cisp-mcp 后终端不动,是不是卡住了?
不是。默认 stdio 模式会等待 MCP 客户端通过标准输入/输出通信,手动运行时看起来像停住。调试时请用:
uv run cisp-mcp --transport streamable-http2. 真实调用报证书错误怎么办?
本地联调时可以临时设置:
CISP_VERIFY_SSL=false生产环境建议保持:
CISP_VERIFY_SSL=true安全说明
不要提交
.env。Streamable HTTP 生产入口必须使用 HTTPS。
不要在代码、README、日志或聊天消息中写入 API Key。
Claude Code、Codex 优先通过环境变量管理 Key;WorkBuddy 优先使用凭据管理界面。
Nginx 和应用日志不得记录
Authorization或转发给 CISP 的X-API-Key。HTTP 模式下每个请求都必须携带 Bearer Key;缺失或格式错误时返回
401。MCP 服务只做 Bearer格式校验;格式正确但已失效的 Key会在实际调用 CISP 时由 CISP 后台拒绝。
代理账号密码属于敏感信息;如果
CISP_ENDPOINT_PROXY包含凭据,不得提交 Git或打印到日志。
Available Tools
14 toolsp0010010_query_business_profileB
企业工商照面信息查询。根据企业名称、统一社会信用代码或工商注册号查询工商注册照面信息。
| Name | Required | Description | Default |
|---|---|---|---|
| ent_info | Yes | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description does not disclose behavioral traits such as whether it is read-only, latency, rate limits, or authentication requirements. As a query tool, read-only behavior is implied but not stated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with two short sentences that convey the essential information without any unnecessary detail. It is front-loaded with the purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the low complexity (2 parameters, simple types) and presence of an output schema, the description is adequate for a basic query tool. However, it lacks behavioral context like error handling or result limitations, which could be important for an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must add meaning. It only hints that 'ent_info' can be an enterprise name, credit code, or registration number, but does not specify format or provide any details for the 'extra_params' parameter. The description does not fully compensate for the lack of schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it queries enterprise business registration information using one of three identifiers (name, credit code, registration number). It uses a specific verb and resource, and is distinct from sibling tools like trademark or patent queries.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description mentions the query inputs (enterprise name, credit code, registration number) but does not explicitly state when to use this tool versus alternatives such as fuzzy search or deep query. No guidance on when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0010058_query_business_basic_deepC
企业工商基本信息查询(深度)。企业名称、统一社会信用代码、注册号、组织机构代码四选一。
| Name | Required | Description | Default |
|---|---|---|---|
| reg_no | No | ||
| ent_name | No | ||
| org_code | No | ||
| credit_code | No | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full responsibility for behavioral disclosure. It states the tool performs a 'deep' query but does not clarify what 'deep' entails, such as scope of data, rate limits, authentication requirements, or if the operation is safe read-only. Basic query intent is implied but not explicitly stated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very concise with two front-loaded sentences. It efficiently conveys the core purpose and parameter selection rule without wasted words, though it could benefit from a clearer structural breakdown.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 5 parameters, no schema descriptions, and an output schema exists, the description is insufficient. It does not explain what 'deep' means, what data the query returns, or that only one identifier should be provided. The output schema exists but the description does not reference or complement it.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0% with no parameter descriptions. The description adds value by explaining the rule that one of four identifiers must be used ('四选一'), but it does not describe the format or constraints of each identifier, nor does it explain the 'extra_params' field. Partial compensation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool queries basic business information (deep) and lists the four acceptable identifier types. However, it does not explicitly differentiate from the sibling tool 'p0010010_query_business_profile', though 'deep' suggests a different scope.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description indicates that exactly one of four identifiers should be provided ('四选一') but provides no guidance on when to use this tool versus alternatives like fuzzy search or business profile query. No prerequisites or exclusion criteria are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0010068_fuzzy_search_company_nameC
企业名称模糊查询(简版)。根据企业名称关键字查询最符合条件的企业名称。
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| ent_name | Yes | ||
| region_id | No | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must disclose behavioral traits. It only states a fuzzy search is performed, but does not mention result limits, ranking criteria, or any side effects. An output schema exists, but behavior is not explained.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short (two sentences) and to the point, with no extraneous words. It could be slightly more informative without sacrificing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 4 parameters and an output schema, the description is insufficient. It fails to explain optional parameters, result format, or any constraints. The tool is relatively simple, so a minimal description is expected, but gaps remain.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0% and description only mentions the '企业名称关键字' (ent_name), ignoring type, region_id, and extra_params. The description adds no meaning beyond the parameter names themselves.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool performs a fuzzy search of company names by keyword, distinguishing it from sibling tools that query specific business data (trademarks, patents, etc.). The phrase '简版' hints at a simplified version, but no full version is listed.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives, or what the optional parameters (type, region_id, extra_params) are for. The description only implies usage for keyword-based fuzzy matching.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0010073_query_trademark_infoC
企业商标信息查询。通过企业名称或企业证件号查询商标信息。
| Name | Required | Description | Default |
|---|---|---|---|
| page_no | No | ||
| ent_info | Yes | ||
| page_size | No | ||
| tm_reg_no | No | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must fully disclose behavior. It only states the query method (by enterprise name or document number) but omits details such as pagination (page_no, page_size), the role of tm_reg_no and extra_params, any required permissions, or the structure of the response. This leaves significant gaps for the agent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short and to the point, but it lacks structure (e.g., no separation of purpose from parameters). It front-loads the core action but omits important details. While concise, it could be more informative without adding length.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 5 parameters with no schema descriptions, no annotations, and an output schema (unknown content), the description is insufficient. It covers only the basic search criterion but fails to explain pagination, optional filters, or the nature of the returned data.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 5 parameters with zero description coverage. The description only mentions the required 'ent_info' parameter (enterprise name or document number), ignoring the purpose of page_no, page_size, tm_reg_no, and extra_params. An agent cannot infer their semantics without additional information.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool queries trademark information by enterprise name or document number, distinguishing it from sibling tools focused on patents, copyrights, or business profiles. However, it could be more specific about the output (e.g., returning a list of trademarks) to enhance clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The purpose implies it is for trademark queries, and sibling tools cover other IP types (e.g., patent, copyright), so usage context is somewhat clear. However, there is no explicit guidance on when to use this tool vs alternatives, nor any mention of prerequisites or limitations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0010074_query_software_copyright_infoB
企业软件著作权信息查询。根据企业名称、统一社会信用代码或注册号查询软件著作权信息。
| Name | Required | Description | Default |
|---|---|---|---|
| page_no | No | ||
| ent_info | Yes | ||
| page_size | No | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, and the description omits behavioral traits such as pagination behavior, authorization requirements, or rate limits. The agent is left uninformed about side effects or constraints.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences long, front-loaded with the main purpose, and contains no redundant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description adequately states the purpose and key input, but lacks usage guidelines and behavioral details. An output schema exists but is not sufficient to compensate for missing guidance on when and how to use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds meaning for the required 'ent_info' parameter (allowed inputs: name, credit code, registration number), but ignores 'page_no', 'page_size', and 'extra_params'. With 0% schema coverage, more parameter context is needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states it queries 'enterprise software copyright information' and specifies the input criteria (enterprise name, unified social credit code, or registration number). This distinguishes it from sibling tools like trademark or patent queries.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool vs alternatives (e.g., work copyright query). It only describes what it does, without scenarios or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0010075_query_work_copyright_infoB
企业作品著作权信息查询。根据企业名称、工商注册号或统一社会信用代码查询作品著作权信息。
| Name | Required | Description | Default |
|---|---|---|---|
| pub_no | No | ||
| page_no | No | ||
| ent_info | Yes | ||
| page_size | No | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It states a query operation, implying read-only, but lacks details on rate limits, authentication, error handling, or behavior when no results are found.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence with no wasted words. It is front-loaded with the purpose, but could be structured better with additional details.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having 5 parameters and an output schema, the description provides no information on return values or parameter details. It is incomplete for effective use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, and the description does not explain the parameters (e.g., pub_no, page_no, page_size). The schema titles are generic, and the description adds no meaning beyond the parameter names. This is inadequate for correct parameter usage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: querying enterprise work copyright information using enterprise name, business registration number, or unified social credit code. It explicitly distinguishes it from sibling tools like trademark, software copyright, and patent queries.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage when work copyright info is needed but provides no explicit guidance on when to use this tool vs alternatives or any prerequisites. No exclusions or comparisons are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0010076_query_icp_filing_infoA
企业 ICP 备案信息查询。根据企业名称、工商注册号或统一社会信用代码查询 ICP 备案信息。
| Name | Required | Description | Default |
|---|---|---|---|
| page_no | No | ||
| ent_info | Yes | ||
| page_size | No | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden but only states it queries data. It fails to disclose read-only nature, authentication needs, rate limits, or behavior on no results.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence that immediately states the tool's purpose. It is appropriately front-loaded but could benefit from slight expansion on parameters.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 4 parameters, 0% schema coverage, and no annotations, the description is too minimal. It lacks details on pagination, output schema expectations, and usage scenarios beyond the main input.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds meaning to the required parameter 'ent_info' by listing acceptable values (name, registration number, credit code). However, it does not explain 'page_no', 'page_size', or 'extra_params', and schema coverage is 0%.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states the tool queries ICP filing information using enterprise name, registration number, or credit code. It clearly differentiates from sibling tools that handle other business data.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the tool is used for ICP filing queries and specifies acceptable input types for the main parameter. However, it does not explicitly compare with sibling tools or state when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0010078_query_patent_infoC
企业专利信息查询。根据企业名称查询以企业作为专利申请人的专利信息。日期格式 yyyy-MM-dd。
| Name | Required | Description | Default |
|---|---|---|---|
| page_no | No | ||
| end_date | No | ||
| ent_info | Yes | ||
| ptt_type | No | ||
| page_size | No | ||
| start_date | No | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It implies a read operation (query) but does not explicitly state it is read-only, nor does it disclose any behavioral traits like authentication requirements, rate limits, or side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences are concise. First states purpose, second adds date format. Could include more structure but efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 7 parameters and an output schema not shown, description lacks details on pagination (page_no, page_size), filtering by patent type (ptt_type), or extra_params. Date range is hinted but not fully explained. Incomplete for a query tool with many optional parameters.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so description must compensate. It mentions date format for date parameters but provides no meaning for page_no, ptt_type, page_size, extra_params. Only ent_info is implied by '根据企业名称'. Insufficient detail.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it queries patent information with the enterprise as patent applicant, specifying the resource (patent info) and action (query by enterprise name). It distinguishes from siblings focusing on trademarks or copyrights.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like trademark or copyright queries. There are no prerequisites or exclusions mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0050007_p0050008_query_public_opinion_infoC
企业舆情信息查询。先查 P0050007 列表,再用 entryId 和 ent_name 调 P0050008 查询详情。
| Name | Required | Description | Default |
|---|---|---|---|
| page_no | No | 1 | |
| end_date | No | ||
| ent_name | Yes | ||
| page_size | No | 10 | |
| group_name | No | ||
| info_label | No | ||
| start_date | No | ||
| max_details | No | ||
| extra_params | No | ||
| info_emotion | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description mentions a two-step orchestration but does not explain how the tool handles the process (e.g., how entryId is obtained, what happens if multiple results, error handling). It references an 'entryId' parameter that is not present in the input schema, causing confusion. With no annotations provided, the description carries full burden for behavioral disclosure but falls short.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very short (two sentences), which is concise, but it sacrifices essential information. It is front-loaded with the purpose, but lacks parameter details and usage guidance. It could be considered under-specified rather than properly concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite the tool having 10 parameters and an output schema, the description provides minimal context. It does not explain the orchestration logic, date format, pagination, or what the tool returns. An agent would struggle to invoke it correctly without additional knowledge.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. It only mentions 'ent_name' and 'entryId' (entryId not in schema) but does not explain the other 9 parameters like page_no, start_date, end_date, info_label, etc. No format, default behavior, or constraints are given, making it nearly impossible for an agent to use the tool correctly.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: querying enterprise public opinion information. It mentions a two-step process involving P0050007 and P0050008, which adds specificity. However, it does not explicitly differentiate this composite tool from the individual sibling tools p0050007_query_public_opinion_list and p0050008_query_public_opinion_detail, which would help an agent choose between them.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this composite tool versus using the individual sibling tools. There is no mention of prerequisites, scenarios where this is appropriate, or situations where alternatives are better. The description lacks usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0050007_query_public_opinion_listC
企业舆情信息列表查询。ent_name 使用企业名称数组,如 ["证通股份有限公司"],支持多个企业。
| Name | Required | Description | Default |
|---|---|---|---|
| page_no | No | ||
| end_date | No | ||
| ent_name | No | ||
| page_size | No | ||
| group_name | No | ||
| info_label | No | ||
| start_date | No | ||
| extra_params | No | ||
| info_emotion | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden but only mentions the ent_name parameter. It does not disclose read-only nature, pagination, rate limits, or any behavioral quirks. The schema's many parameters are unaddressed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise at two sentences, but it sacrifices completeness. It front-loads the purpose but lacks structure for the many parameters.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 9 parameters, 0% schema coverage, and a presumably rich output schema, the description is severely lacking. It only addresses ent_name, leaving users uninformed about other fields, filters, and result format.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, and the description only explains the ent_name parameter with an example. The other 8 parameters (page_no, end_date, etc.) are completely undocumented, adding no semantic value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it's a query for enterprise public opinion information list and mentions the key parameter ent_name. It distinguishes from sibling tools like p0050008_query_public_opinion_detail by being a list query, but does not explicitly differentiate from other list-type siblings.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. There is no mention of prerequisites, filters, or scenarios where this tool is preferred over others like detail queries or info queries.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0050008_query_public_opinion_detailA
企业舆情信息详情查询。优先使用 entry_id;只传 ent_name 时会先查列表,再取第一条舆情详情。
| Name | Required | Description | Default |
|---|---|---|---|
| ent_name | No | ||
| entry_id | No | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description bears the burden. It discloses the two-step process when using ent_name, but omits details on side effects, rate limits, or authorization requirements.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, efficient and front-loaded with key behavioral information. No unnecessary words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema, the description covers the main usage pattern. However, it lacks details on extra_params and edge cases (e.g., both parameters provided).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, but the description adds meaning for entry_id and ent_name by explaining their usage priority. The extra_params parameter remains undocumented.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the tool queries enterprise public opinion details, and provides specific guidance on using entry_id or ent_name. It clearly distinguishes from siblings like p0050007_query_public_opinion_list.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description advises preferring entry_id and explains the behavior when only ent_name is passed. However, it does not explicitly state when not to use this tool or compare with siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0060007_verify_business_two_elementsA
企业工商二要素验证。根据企业名称和统一社会信用代码/企业注册号验证是否匹配。
| Name | Required | Description | Default |
|---|---|---|---|
| reg_no | Yes | ||
| ent_name | Yes | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description indicates the tool performs a verification (matching check), which is a read-only operation. No annotations are provided, but the description does not contradict any potential annotations. It does not detail side effects, authentication needs, or rate limits, but for a simple verification tool, this is minimally adequate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that is front-loaded with the tool's function. Every word is essential and there is no redundant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity and the presence of an output schema, the description is moderately complete. It fails to mention prerequisites or error scenarios, but it covers the core purpose and inputs adequately for most use cases.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, and the description only mentions the parameters in a general sense ('企业名称' and '统一社会信用代码/企业注册号'). It does not provide format, constraints, or examples, leaving significant gaps for an agent to correctly invoke the tool.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states that the tool verifies two elements of business (name and registration number). It uses specific verbs and resources, and it distinguishes itself from the sibling tool 'p0060008_verify_business_three_elements' by specifying 'two elements'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for verifying business name and registration number matching, but it does not explicitly state when to use this tool over alternatives like the three-element verification or query profiles. No exclusions or alternatives are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
p0060008_verify_business_three_elementsA
企业工商三要素验证。根据企业名称、统一社会信用代码/注册号和法定代表人姓名验证是否一致。
| Name | Required | Description | Default |
|---|---|---|---|
| reg_no | Yes | ||
| fr_name | Yes | ||
| ent_name | Yes | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must fully disclose behavioral traits. It only states 'verify consistency' without detailing what happens on success/failure, side effects, authentication needs, or rate limits. Basic safety profile is unclear.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence conveying the core purpose. It is efficient but could benefit from slight restructuring (e.g., bullet points) for readability.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description covers the basic purpose but does not mention return values, error handling, or output schema behavior. With an output schema present but not referenced, more detail would improve completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. The description names the three required parameters in natural language (企业名称, 统一社会信用代码/注册号, 法定代表人姓名) corresponding to ent_name, reg_no, fr_name, adding meaning beyond bare schema. However, extra_params is not explained.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool verifies consistency of three business elements (name, credit code/registration number, legal representative). It uses a specific verb 'verify' and resource 'business three elements', distinguishing it from siblings like the two-element verification tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies use for three-element verification but does not explicitly state when to use this tool versus alternatives (e.g., two-element verification). No guidance on prerequisites or context is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
query_cisp_productC
Generic CISP JSON gateway query. Prefer product-specific tools when available.
| Name | Required | Description | Default |
|---|---|---|---|
| ent_info | Yes | ||
| prod_code | Yes | ||
| extra_params | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, and the description provides no behavioral details such as error handling, rate limits, or authentication requirements.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very concise but at the expense of critical information; not optimally structured for an AI agent.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema and many sibling tools, the description lacks any context about return values or usage scenarios.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0% and description does not explain any of the three parameters beyond names.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description identifies tool as 'Generic CISP JSON gateway query' and contrasts with product-specific tools, making purpose clear despite lack of detail.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly states 'Prefer product-specific tools when available,' providing clear when-to-use and when-not-to-use guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
14 tool updates
v0.1.0- First observed
p0010010_query_business_profile - First observed
p0010058_query_business_basic_deep - First observed
p0010068_fuzzy_search_company_name - First observed
p0010073_query_trademark_info - First observed
p0010074_query_software_copyright_info - First observed
p0010075_query_work_copyright_info - First observed
p0010076_query_icp_filing_info - First observed
p0010078_query_patent_info - First observed
p0050007_p0050008_query_public_opinion_info - First observed
p0050007_query_public_opinion_list - First observed
p0050008_query_public_opinion_detail - First observed
p0060007_verify_business_two_elements - First observed
p0060008_verify_business_three_elements - First observed
query_cisp_product
TDQS
Each tool targets a distinct type of business information (profile, basic deep, fuzzy search, trademark, copyrights, ICP, patent, public opinion list/detail, verification, and generic fallback). There is no overlap; even the public opinion tools are split into list and detail, which is clear.
Most tools follow a pattern of numeric prefix + verb_noun (e.g., p0010010_query_business_profile), but the last tool 'query_cisp_product' lacks the numeric prefix, breaking consistency. Additionally, verbs vary (query, fuzzy_search, verify), though that is common.
14 tools cover a wide range of business information queries (basic, intellectual property, public opinion, verification) without being excessive. The count is well-scoped for a specialized business data server.
The toolset covers major business information categories (profile, IP, ICP, public opinion, verification). Minor gaps like financial data or legal records exist, but the generic 'query_cisp_product' tool serves as a fallback, mitigating incompleteness.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
MCP server giving AI agents one-connection access to China A-share market intelligence: financials,
CompanyLens is a remote MCP server giving AI agents instant access to official company registry data across 19 jurisdictions in Europe, the Americas, and Asia-Pacific. Eighteen read-only tools let you search companies and people, look up officers and beneficial owners, map corporate networks through shared directors, screen names against the UK disqualified directors register, find every company at a registered address, and pull filing history — all from a single connector. Visit our website: https://companylens.io
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceAn MCP-based enterprise tools server that exposes company knowledge search and employee database lookup as callable tools.-
- FlicenseAqualityDmaintenanceAn MCP server that gives AI agents access to US business entity data, enabling searches across 9 state registries, SEC EDGAR filings, federal contracts, and lobbying disclosures.61-

CNBizAPI MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceEnables AI agents to query detailed information on 77M+ Chinese companies, including basic data, shareholders, legal risks, and more, through a pay-per-query MCP server.MIT
whetstone-mcpofficial
AlicenseAqualityBmaintenanceAn MCP server for U.S. public-records data, enabling AI agents to search business registrations, screen names against government watchlists, and pull federal awards.446MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/fw-magic/cisp-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server