Skip to main content
Glama

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.11

  • uv

  • 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-mcp

2. 检查 Python 和 uv

检查 Python:

python3 --version

检查 uv:

uv --version

如果没有安装 uv,可以按 uv 官方方式安装,或使用本机已有的 Python 环境安装。

3. 安装依赖

uv sync

4. 配置环境变量(本地 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=true

CISP_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_PROXYHTTPS_PROXYALL_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

P0010010

企业工商照面信息查询

p0010010_query_business_profile

P0010058

企业工商基本信息查询(深度)

p0010058_query_business_basic_deep

P0010059

企业工商基本信息查询(简项)

p0010059_query_business_basic_brief

P0010068

企业名称模糊查询(简版)

p0010068_fuzzy_search_company_name

P0010073

企业商标信息查询

p0010073_query_trademark_info

P0010074

企业软件著作权信息查询

p0010074_query_software_copyright_info

P0010075

企业作品著作权信息查询

p0010075_query_work_copyright_info

P0010076

企业 ICP 备案信息查询

p0010076_query_icp_filing_info

P0010078

企业专利信息查询

p0010078_query_patent_info

P0010084

企业许可信息查询

p0010084_query_license_info

P0020014

企业疑似关系信息查询

p0020014_query_suspected_relationships

P0020019

企业疑似实际控制人信息查询

p0020019_query_suspected_controller

P0020021

企业单点关联信息查询

p0020021_query_single_point_related_info

P0020023

企业股权穿透信息查询

p0020023_query_equity_penetration

P0020024

企业受益股东详细查询

p0020024_query_beneficial_shareholders_detailed

P0020031

企业多点关联信息查询

p0020031_query_multi_point_relationships

P0020044

企业间关联关系查询

p0020044_query_intercompany_relationship

P0020129

企业实控人和最终受益人查询

p0020129_query_controller_and_ubo

P0050007

企业舆情信息列表查询

p0050007_query_public_opinion_list

P0050008

企业舆情信息详情查询

p0050008_query_public_opinion_detail

P0050007+P0050008

企业舆情信息查询(列表+详情)

p0050007_p0050008_query_public_opinion_info

P0060007

企业工商二要素验证

p0060007_verify_business_two_elements

P0060008

企业工商三要素验证

p0060008_verify_business_three_elements

P0090001 / P0090012

企业最终受益人信息查询(详版/非详版)

p0090001_p0090012_query_ubo

P0090008

企业实际控制人信息查询

p0090008_query_actual_controller

P0090011

企业最终受益人信息查询-全路径版

p0090011_query_ubo_full_paths

P0110003

企业荣誉资质信息查询

p0110003_query_honor_qualification_info

P0130025

企业关键指标信息查询

p0130025_query_company_key_indicators

P0130036

企业土地信息查询

p0130036_query_land_info

P0130038

企业画像-行业分析

p0130038_query_industry_analysis

P0210004

上市公司财务数据查询

p0210004_query_listed_company_financial_data

P0980006

企业高级筛选

p0980006_query_advanced_company_filter

P0980008

纳税评级

p0980008_query_tax_rating

P0980023

光大-近2年风险分析统计

p0980023_query_two_year_risk_summary

P0980033

上市投融资招投标知识产权情况

p0980033_query_listing_financing_bidding_ipr

P0990022

供应商关联关系

p0990022_query_supplier_relationships

通用

CISP JSON 网关调试查询

query_cisp_product

返回结构

专用工具会返回归一化字段和原始响应:

  • product_code:产品码

  • interface_name:接口名称

  • successresultCode == "00000"

  • has_result:产品状态码为 4

  • result_code_desc:结果码说明

  • product_status_desc:产品状态说明

  • data:产品数据对象

  • raw_response:CISP 原始返回

如果产品数据里存在常用列表字段,也会额外透出快捷字段,例如:

  • basicList

  • fuzzyList

  • brandList

  • swList

  • resultList

  • icpList

  • patentsList

  • detailListP0010084P0130036

  • suspectList

  • controlNodeList

  • entInvList

  • nodeListP0020024

  • nodes

  • relationship

  • dataList

  • finalListP0090001P0090012

  • actualControllerP0090008

  • MatchInfoList

  • infoList

  • infoDetail

  • matchList

  • itemNameList

  • coreLndicatorInfoP0130025,字段名沿用底层接口原始拼写)

  • suppListP0990022

  • entListP0980006

  • listP0980008P0980023

  • dataP0980033

P0210004 会根据 financial_typedata 中填充对应列表: rgincomeInforgcashflowInfofncmfninInforgbalanceInfomainfinadataInfobalanceInfoincomeInfocashflowInfo

调用示例

查询工商照面信息

{
  "ent_info": "证通股份有限公司"
}

对应工具:

p0010010_query_business_profile

查询深度工商信息

{
  "ent_name": "证通股份有限公司"
}

对应工具:

p0010058_query_business_basic_deep

查询简项工商信息

ent_namecredit_codereg_noorg_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 可选值:finRankfinRankStockentRegionRanklocfinindLocOprindLocOprFinpropertyfinancialRegionRank。不同类型的结果字段不同,统一从返回的 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_dateend_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 产品接口:

  1. 把 PDF 接口文档放到本地 docs/ 目录。

  2. 阅读基本信息、请求参数、返回字段和附录状态码。

  3. src/cisp_mcp/interfaces.py 中新增产品定义。

  4. src/cisp_mcp/server.py 中新增一个 @mcp.tool()

  5. 工具名格式建议为:p产品号_英文语义名,例如 p0010010_query_business_profile

  6. 更新 scripts/smoke_test_mcp.pyEXPECTED_TOOLS

  7. 运行 smoke test:

uv run python scripts/smoke_test_mcp.py

常见问题

1. 手动运行 uv run cisp-mcp 后终端不动,是不是卡住了?

不是。默认 stdio 模式会等待 MCP 客户端通过标准输入/输出通信,手动运行时看起来像停住。调试时请用:

uv run cisp-mcp --transport streamable-http

2. 真实调用报证书错误怎么办?

本地联调时可以临时设置:

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 tools
p0010010_query_business_profileB

企业工商照面信息查询。根据企业名称、统一社会信用代码或工商注册号查询工商注册照面信息。

ParametersJSON Schema
NameRequiredDescriptionDefault
ent_infoYes
extra_paramsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

B3.4/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters2/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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

企业工商基本信息查询(深度)。企业名称、统一社会信用代码、注册号、组织机构代码四选一。

ParametersJSON Schema
NameRequiredDescriptionDefault
reg_noNo
ent_nameNo
org_codeNo
credit_codeNo
extra_paramsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.9/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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

企业名称模糊查询(简版)。根据企业名称关键字查询最符合条件的企业名称。

ParametersJSON Schema
NameRequiredDescriptionDefault
typeNo
ent_nameYes
region_idNo
extra_paramsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.6/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness2/5

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.

Parameters1/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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

企业商标信息查询。通过企业名称或企业证件号查询商标信息。

ParametersJSON Schema
NameRequiredDescriptionDefault
page_noNo
ent_infoYes
page_sizeNo
tm_reg_noNo
extra_paramsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.7/5.0
Behavior2/5

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.

Conciseness3/5

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.

Completeness2/5

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.

Parameters1/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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.

p0010076_query_icp_filing_infoA

企业 ICP 备案信息查询。根据企业名称、工商注册号或统一社会信用代码查询 ICP 备案信息。

ParametersJSON Schema
NameRequiredDescriptionDefault
page_noNo
ent_infoYes
page_sizeNo
extra_paramsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.5/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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。

ParametersJSON Schema
NameRequiredDescriptionDefault
page_noNo
end_dateNo
ent_infoYes
ptt_typeNo
page_sizeNo
start_dateNo
extra_paramsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.7/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness2/5

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.

Parameters2/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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 查询详情。

ParametersJSON Schema
NameRequiredDescriptionDefault
page_noNo1
end_dateNo
ent_nameYes
page_sizeNo10
group_nameNo
info_labelNo
start_dateNo
max_detailsNo
extra_paramsNo
info_emotionNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.4/5.0
Behavior2/5

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.

Conciseness3/5

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.

Completeness2/5

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.

Parameters1/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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 使用企业名称数组,如 ["证通股份有限公司"],支持多个企业。

ParametersJSON Schema
NameRequiredDescriptionDefault
page_noNo
end_dateNo
ent_nameNo
page_sizeNo
group_nameNo
info_labelNo
start_dateNo
extra_paramsNo
info_emotionNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.6/5.0
Behavior2/5

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.

Conciseness3/5

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.

Completeness2/5

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.

Parameters2/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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 时会先查列表,再取第一条舆情详情。

ParametersJSON Schema
NameRequiredDescriptionDefault
ent_nameNo
entry_idNo
extra_paramsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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

企业工商二要素验证。根据企业名称和统一社会信用代码/企业注册号验证是否匹配。

ParametersJSON Schema
NameRequiredDescriptionDefault
reg_noYes
ent_nameYes
extra_paramsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.6/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters2/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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

企业工商三要素验证。根据企业名称、统一社会信用代码/注册号和法定代表人姓名验证是否一致。

ParametersJSON Schema
NameRequiredDescriptionDefault
reg_noYes
fr_nameYes
ent_nameYes
extra_paramsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.6/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness3/5

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.

Parameters4/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
ent_infoYes
prod_codeYes
extra_paramsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.8/5.0
Behavior1/5

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.

Conciseness3/5

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.

Completeness1/5

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.

Parameters1/5

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.

Purpose4/5

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.

Usage Guidelines5/5

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.

  1. 14 tool updatesv0.1.0
    • First observedp0010010_query_business_profile
    • First observedp0010058_query_business_basic_deep
    • First observedp0010068_fuzzy_search_company_name
    • First observedp0010073_query_trademark_info
    • First observedp0010074_query_software_copyright_info
    • First observedp0010075_query_work_copyright_info
    • First observedp0010076_query_icp_filing_info
    • First observedp0010078_query_patent_info
    • First observedp0050007_p0050008_query_public_opinion_info
    • First observedp0050007_query_public_opinion_list
    • First observedp0050008_query_public_opinion_detail
    • First observedp0060007_verify_business_two_elements
    • First observedp0060008_verify_business_three_elements
    • First observedquery_cisp_product

TDQS

B3.2/5.0
Disambiguation5/5

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.

Naming Consistency3/5

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.

Tool Count5/5

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.

Completeness4/5

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

ActivityActive
ResponsivenessNo issues

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

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    An 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.
    6
    1
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables 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
  • A
    license
    A
    quality
    B
    maintenance
    An MCP server for U.S. public-records data, enabling AI agents to search business registrations, screen names against government watchlists, and pull federal awards.
    4
    46
    MIT

Latest Blog Posts

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