HtAG Documentation MCP Server

什么是 HtAG Docs MCP Server？

HtAG Docs MCP Server 是 HtAG 提供的公开、无需认证的 MCP 服务器，可让 AI 助手了解 HtAG 的澳大利亚房产数据平台：其 MCP 服务器和工具、带完整 OpenAPI 细节的 REST API 端点，以及开箱即用的微智能体。

HtAG 是一家澳大利亚房产情报提供商。其开发者平台提供 89 个以上的 REST 端点，涵盖市场分析、房产数据、H3 空间指标、人口统计和经济数据，还有 4 个 MCP 服务器（75 个以上工具）以及用于郊区分析等任务的 AI 微智能体。Docs 服务器是免费的入口：在任何人订阅数据套餐之前，智能体就可以用它找出适合某个用例的端点、工具或智能体，并确保参数与实时规范一致。它在 Claude 目录中的名称为“HtAG Documentation”。

如何使用 HtAG Docs MCP Server？

Docs 服务器不需要 API key、OAuth 登录或账号。把客户端指向：

https://api.htagai.com/mcp/v1/servers/htag-docs/mcp

Claude Code

claude mcp add --transport http htag-docs https://api.htagai.com/mcp/v1/servers/htag-docs/mcp

Claude Desktop 和 claude.ai

从 Claude 的连接器目录中添加 HtAG Documentation，或打开 Settings → Connectors → Add custom connector 粘贴上面的 URL。之后没有认证步骤。

Cursor

在 ~/.cursor/mcp.json 中：

{
  "mcpServers": {
    "htag-docs": {
      "url": "https://api.htagai.com/mcp/v1/servers/htag-docs/mcp"
    }
  }
}

VS Code

在 .vscode/mcp.json 中：

{
  "servers": {
    "htag-docs": {
      "type": "http",
      "url": "https://api.htagai.com/mcp/v1/servers/htag-docs/mcp"
    }
  }
}

当你准备查询数据时，HtAG 的 Intelligence 和 Spatial 服务器在 Claude 中使用 OAuth，在 Cursor 和 ChatGPT 等客户端中使用 x-api-key 请求头；主 Intelligence 端点为 https://api.htagai.com/mcp/v1/servers/htag/mcp。

HtAG Docs MCP Server 的主要功能

• 公开服务器：HtAG 开发者文档将其认证方式标为“Public”，说明“no auth required”。
• 列出 HtAG 提供的所有 MCP 服务器，包括挂载路径以及是否公开。
• 列出指定服务器上的所有工具，包括每个工具的 JSON Schema 输入。
• 按标签（如 Markets、Property 或 Spatial）或文本搜索 HtAG 的公开 REST 目录。
• 返回某个端点的完整 OpenAPI 操作，包括参数、请求体、响应和示例。
• 列出 HtAG 微智能体，例如郊区分析、郊区比较和全面尽职调查。

HtAG Docs MCP Server 工具

服务器有五个工具，分为两组。

MCP 发现。 list_mcp_servers 返回每个 HtAG MCP 服务器的名称、描述、挂载路径和是否公开。list_mcp_tools 接收该列表中的服务器名称，返回其上注册的所有工具及输入 schema。

API 和智能体发现。 list_api_endpoints 列出 HtAG 的公开 REST 端点，可按 tag 或 query 筛选，返回路径、方法、operationId、标签和摘要。get_api_endpoint 返回某个端点的完整 OpenAPI 操作；其描述要求模型在推荐端点前先调用它，以确保参数提示与实时规范一致。list_micro_agents 列出可调用的微智能体，例如 suburb-analysis、suburb-comparison 和 comprehensive-dd。

HtAG Docs MCP Server 的使用场景

• 规划集成：“HtAG 哪些端点按郊区返回租金收益率？需要哪些参数？”
• 编写客户端代码：“获取 locality 参考端点的完整 OpenAPI 规范，并写一个 TypeScript fetch 调用。”
• 在数据和智能体之间选择：“HtAG 有比较郊区的微智能体吗？还是我应该串联多个端点？”
• 工具清单：“列出 HtAG Spatial MCP 服务器上的工具及其输入。”
• 注册前评估平台：“HtAG 涵盖哪些房产和市场数据？”

HtAG Docs MCP Server 常见问题排查

• 你想要的是房产数据而不是文档。 这个服务器只描述平台本身。实际数据请使用需要 OAuth 或 API key 的 HtAG Intelligence 或 Spatial 服务器。
• get_api_endpoint 返回 null。 该端点不在公开目录中；用 list_api_endpoints 加 tag 或 query 查找正确路径。
• list_mcp_tools 什么都没找到。 请完全按照 list_mcp_servers 返回的名称传入服务器名。