advisorscope

advisorscope

查询投资建议背后的个人和公司。 advisorscope 是一个无需密钥的转发客户端，连接托管的 AdvisorFinder MCP 端点，该端点提供 SEC 注册数据：个人 投资顾问代表、他们任职的公司、在市场平台上列出且实际可以 预约的顾问，以及整个数据库的统计信息。

无需进行本地配置，也无需创建账户。此软件包包含工具定义和 少量防护措施；每次查询都会转发到托管端点，返回的答案会 完全按照远程服务生成的内容，以 JSON 文本形式序列化。

转发工作原理

每次工具调用都会与远程 MCP 服务建立一个新会话，并通过以下 三个步骤完成：

1. 发送 initialize JSON-RPC POST（协议版本 2025-03-26，客户端 advisorscope/0.1.0）；捕获 mcp-session-id 响应标头。
2. 发送携带该会话标头的 notifications/initialized POST。
3. 发送包含工具名称和参数的 tools/call POST，原样转发—— 不添加、重命名或删除任何内容。

纯 JSON 和 SSE 格式的响应均可处理。远程 JSON-RPC 错误会作为 携带远程消息的错误结果返回；非 2xx 响应会以 advisorfinder error: HTTP <status> 失败；无法访问端点时会以 advisorfinder unreachable 失败。不会重试。

配置

• 不会发送 API 密钥、账户信息或 Authorization 标头。
• ADVISORFINDER_MCP_URL（可选）——远程 MCP 端点。默认为 https://mcp.advisorfinder.com/mcp。

工具

• search_advisors — 搜索符合 name、 firm、city 和／或 state 条件的投资顾问代表。每条匹配结果都包含 CRD、关联公司、四种状态之一的披露状态，以及 SEC IAPD 链接。
• get_advisor — 获取单个 crd 对应的完整个人资料： 任职历史、已通过的考试、注册所在州、自报的资格认证、从业年限和 披露状态。
• check_advisor — 通过 crd 或 name 快速核查注册情况， 可选按 firm 和／或 state 缩小范围： 是否在册、注册所在州、从业年限、披露状态。仅提供事实——绝不提供数值风险 评分。
• find_bookable_advisors — 搜索 AdvisorFinder 市场平台上列出的顾问， 可按 specialty、city 和／或 state 筛选，并显示顾问自行提供的个人资料 详情及其 CRD 背后的监管事实（如果某个顾问未收录在 SEC 数据集中，则会以注明标签的 说明标示）。
• search_firms — 搜索符合 name 和／或 state 条件的注册公司， 并显示 CRD、城市／州、AUM 范围、顾问人数及 SEC IAPD 链接。
• get_firm — 获取单家公司 crd 对应的完整资料： 办公地点、其他名称和曾用名、可用时 Form ADV Part 2A 中的费用表、 纪律处分标记及顾问名录人数。
• get_database_stats — 公司和顾问总数、各上游数据源的数据版本，以及完整的 四种状态披露统计。无需参数。

本地防护措施

在发送任何内容之前，会在本地运行两项检查：

• get_advisor 和 get_firm 需要非空的 crd； 如果没有，则会以 crd must be a non-empty string 失败，且不会发出请求。
• check_advisor 至少需要 crd 或 name 中的一项； 如果两者都没有，则会以 check_advisor requires crd or name 失败，且不会发出请求。

其余所有内容都会按给定值转发——剩余参数的校验由远程服务负责。

来源说明

工具列表及各工具的含义来自上游软件包发布的说明。其中两部分为重构内容， 并已注明：各工具的参数集合依据说明中记录的参数语义，而非表格化架构； Streamable HTTP 会话握手则遵循托管 MCP 端点的标准会话模式。

CLI

每个工具都是一个子命令，接受一个 JSON 参数字符串：

npx @reneturcios/advisorscope search_advisors '{"state":"CA","city":"San Francisco"}'
npx @reneturcios/advisorscope get_advisor '{"crd":"123456"}'
npx @reneturcios/advisorscope check_advisor '{"name":"Jane Doe","state":"NY"}'
npx @reneturcios/advisorscope find_bookable_advisors '{"specialty":"retirement","state":"TX"}'
npx @reneturcios/advisorscope search_firms '{"name":"Acme","state":"DE"}'
npx @reneturcios/advisorscope get_firm '{"crd":"789012"}'
npx @reneturcios/advisorscope get_database_stats '{}'
npx @reneturcios/advisorscope --version

输出为工具的结果文本（成功时，将远程结果序列化为 JSON）。退出代码：成功时为 0，出现错误结果（包括防护、远程或传输失败）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/advisorscope mcp

MCP 客户端配置：

{
  "mcpServers": {
    "advisorscope": {
      "command": "npx",
      "args": ["-y", "@reneturcios/advisorscope", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/advisorscope
docker run --rm ghcr.io/cloudcorprecords/advisorscope get_database_stats '{}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

许可证

MIT — 版权所有 (c) 2026 Rene Turcios