关于 htag-docs
htag-docs 是 HTAG 公开 MCP 连接器的能力发现服务,面向需要了解和配置 HTAG 工具的 AI 客户端与集成方。它可列出服务器、工具、REST 端点、OpenAPI 操作和微型 Agent;此仓库发布的是元数据。
主要功能
- 01发现公开 MCP 服务和工具
- 02列出 REST API 端点及 OpenAPI 操作
- 03查找微型 Agent
- 04公开连接器无需身份验证
- 05访问只读房产与空间情报工具
适用场景
- 01确认可用的 HTAG MCP 能力
- 02评估并配置 HTAG 连接器
- 03发现房产和空间数据工具
MCP 相关
HTAG Docs 是无需认证的公开 MCP 连接器,用于发现 HTAG 服务、工具、REST 端点、OpenAPI 操作和微型 Agent。HTAG Intelligence 与 HTAG Spatial 连接器则提供只读房产及空间情报工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.htagai.com/mcp/v1/servers/htag-docs/mcpclaude mcp add --transport http com-htagai-htag-docs https://api.htagai.com/mcp/v1/servers/htag-docs/mcp{"mcpServers":{"com-htagai-htag-docs":{"type":"http","url":"https://api.htagai.com/mcp/v1/servers/htag-docs/mcp"}}}在 Cursor 中打开{"servers":{"com-htagai-htag-docs":{"type":"http","url":"https://api.htagai.com/mcp/v1/servers/htag-docs/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-htagai-htag-docs":{"type":"http","url":"https://api.htagai.com/mcp/v1/servers/htag-docs/mcp"}}}{"mcpServers":{"com-htagai-htag-docs":{"serverUrl":"https://api.htagai.com/mcp/v1/servers/htag-docs/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
5此工具无需参数。
详细介绍
HTAG Property Intelligence MCP
HTAG Property Intelligence MCP 为 AI Agent 提供对澳大利亚房产情报的只读访问:地址标准化、房产摘要和估值、已售/已出租房源搜索、郊区/LGA 市场指标、人口统计、经济数据、地理对应关系及 H3 空间图层。
此代码仓库发布 HTAG 公共模型上下文协议(MCP)服务的元数据——三个连接器共提供 70 多个只读公共工具——以便 AI 客户端、MCP 目录和集成合作伙伴发现、评估并配置这些服务。
Agent 可以用它做什么
- 标准化并丰富地址信息。 将澳大利亚的自由文本地址解析为规范格式,然后获取该地点的房产摘要、人口统计和环境信息。
- 估算房产价值和租金。 获取房产当前的价格和租金估值,以及其所在郊区或 LGA 的市场背景(增长、评分、趋势)。
- 搜索可比销售和租赁房源。 按位置、属性和时间范围筛选已售及已出租房源,为可比案例分析和租金基准评估提供支持。
- 分析郊区、LGA 或邮政编码。 汇总市场指标、人口统计、人口普查中位数和经济指标(CPI、现金利率),查看单一地点的概况。
- 分析空间图层。 获取基于 H3 六边形索引的价格/租金/收益率图层、社会环境指标和风险图层;在 H3 单元格与行政区划之间转换。
- 在运行时发现功能。 通过公共 Docs 连接器列出可用的 MCP 服务、工具、REST 端点和微型 Agent;无需凭据。
连接器
| 连接器 | 注册名称 | 端点 | 工具 | 身份验证 |
|---|---|---|---|---|
| HTAG Intelligence | com.htagai/htag-intelligence | https://api.htagai.com/mcp/v1/servers/htag/mcp | 59 个只读工具 | OAuth 2.0 或 x-api-key |
| HTAG Spatial | com.htagai/htag-spatial | https://api.htagai.com/mcp/v1/servers/htag-spatial/mcp | 6 个只读工具 | OAuth 2.0 或 x-api-key |
| HTAG Docs | com.htagai/htag-docs | https://api.htagai.com/mcp/v1/servers/htag-docs/mcp | 5 个只读工具 | 公共(无需身份验证) |
所有连接器均使用 Streamable HTTP 传输方式。
HTAG Intelligence
只读房产情报工具,涵盖地址标准化、房产摘要和估值、已售/已出租房源搜索、郊区和 LGA 市场指标、市场趋势、人口统计、经济数据,以及 HTAG 房产数据集中的地理对应关系。
HTAG Spatial
只读 H3 空间工具,涵盖基于六边形索引的价格、租金和收益率图层、社会环境指标、风险图层、H3 几何及分辨率工具,以及 H3 与行政区划之间的对应关系。
HTAG Docs
公共功能发现连接器,可列出 HTAG MCP 服务及其工具、REST API 端点和 OpenAPI 操作,以及微型 Agent。无需身份验证。
端点
所有端点都接受通过 HTTPS 使用 Streamable HTTP 发送的 MCP 请求:
https://api.htagai.com/mcp/v1/servers/htag/mcp
https://api.htagai.com/mcp/v1/servers/htag-spatial/mcp
https://api.htagai.com/mcp/v1/servers/htag-docs/mcp
身份验证
- OAuth 2.0——推荐用于面向最终用户的交互式 Agent。授权服务器元数据可直接从各 MCP URL 发现;支持使用授权码 + PKCE 进行动态客户端注册的客户端,无需预先创建 OAuth 客户端或 API 密钥即可让用户登录。
x-api-keyheader——可选的替代方式,适用于服务器到服务器或无头 Agent。通过 Developer Portal 创建密钥,并将其作为请求头传递。- 公共——HTAG Docs 无需凭据。
切勿将 API 密钥提交到源代码管理中的客户端配置文件。请将密钥存储在客户端的机密存储区或环境变量中。
范围与安全
- 仅限公开范围。 本仓库介绍可安全对外开放的三个连接器(Intelligence、Spatial、Docs)。内部/非公开连接器不会列在此处。
- 只读。 所有连接器均为只读;这些 MCP 服务不会修改任何 HTAG 数据。
- 仅使用 HTTPS。 请求和响应均仅通过 HTTPS 传输。
- 交互式客户端无需预先配置。 OAuth 2.0 元数据直接从 MCP URL 发现,并支持动态客户端注册以及授权码 + PKCE,因此支持 MCP 的客户端无需预先创建 OAuth 客户端或 API 密钥即可完成登录。API 密钥仍可作为无头使用的可选替代方式,并通过 HTAG Developer Portal 签发;切勿将其提交到源代码管理中的 MCP 客户端配置。
- 仅限元数据。 这是一个元数据仓库,不会在此发布服务端源代码、各工具的架构或运行细节。实时工具清单以各服务的
tools/list响应和 API 参考 为准。 - 身份与审计。 API 密钥用于识别调用方,以便进行速率限制、配额管理和审计;请通过 Developer Portal 轮换密钥。
- 条款。 关于可接受使用、数据保留和物业数据再分发,请参阅 Developer Portal。
本公开列表不包含的内容
- 内部/非公开的 HTAG 连接器。
- 各工具的输入/输出架构——请参阅实时
tools/list响应或 API 参考。 - 内部路由、基础设施和实现细节。
链接
- Developer Portal - https://developer.htagai.com
- MCP 设置中心 - https://developer.htagai.com/agents-mcp
- API 参考 - https://developer.htagai.com/api-reference
- 支持 - [email protected]
- 安全问题披露 - 请参阅 SECURITY.md
许可证
MIT (c) HTAG Analytics
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。