{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_umk48z85h2yj","handle":"usmartsg-mcp-directory","url":"https://wellknown.network/agents/usmartsg-mcp-directory","links":{"self":"https://wellknown.network/agents/usmartsg-mcp-directory/record.json","html":"https://wellknown.network/agents/usmartsg-mcp-directory","markdown":"https://wellknown.network/agents/usmartsg-mcp-directory/record.md","api":"https://wellknown.network/api/v1/agents/usmartsg-mcp-directory","status":"https://wellknown.network/api/v1/agents/usmartsg-mcp-directory/status","claim":"https://wellknown.network/agents/usmartsg-mcp-directory/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/usmartsg-mcp-directory/claim.json","badge":"https://wellknown.network/agents/usmartsg-mcp-directory/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/usmartsg-mcp-directory/history","tools":"https://wellknown.network/api/v1/agents/usmartsg-mcp-directory/tools"},"ard":{"identifier":"urn:air::server:usmartsg-mcp-directory","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"usmartsg-mcp-directory","summary":"Read-only remote MCP server edition for the uSmart SG OpenAPI, for ChatGPT and Claude directories","description":"# usmartsg-mcp-directory\n\nuSmart SG OpenAPI 的**只读远程 MCP 发行版**，供 ChatGPT / Claude 官方目录的远程\n服务端部署使用。它由同一仓库的 `usmartsg-mcp` 源码生成，但构建期固定为目录只读形态：\n\n- 只注册 5 个只读工具：`get_profile`、`preview_order`、`list_today_orders`、\n  `list_all_orders`、`get_order_detail`；\n- 不注册 `place_order` / `modify_order`，也不注册本地 OAuth 授权与凭证自检工具；\n- `USMART_PROFILE` 被固定为 `directory`：显式设为 `local` 或拼写错误都会在启动时\n  报错退出，不会静默回退到暴露写工具的本地版；\n- 工具描述、服务端说明与错误信息使用英文，且不回显本机路径、账户标识或令牌；\n- 查询与预检工具返回 V2 结构化字段，失败统一为错误信封（见仓库 `README.md`\n  「工具返回契约 V2」）。\n\n## 安装与启动\n\n```bash\npip install usmartsg-mcp-directory\n# 或固定版本：uvx --from \"usmartsg-mcp-directory==1.0.0\" usmartsg-mcp-directory\n\nusmartsg-mcp-directory \\\n  --transport streamable-http \\\n  --host 0.0.0.0 --port 8000 \\\n  --allow-unauthenticated-http \\\n  --allowed-host <你的公网域名>\n```\n\n需要放在带认证、限流与审计的反向代理 / API 网关之后：本包的 HTTP 传输不包含\nMCP 层认证，`--allow-unauthenticated-http` 只解除回环地址绑定限制。\n`--allowed-host` 必填：`--host 0.0.0.0` 时若缺省，真实域名 Host 会被 MCP 传输层\n以 421 拒绝。\n\n## 域名验证\n\nChatGPT 门户连接 MCP 时会给出一个验证 token，部署时通过环境变量注入：\n\n```bash\nUSMART_OPENAI_CHALLENGE=<门户给的 token>\n```\n\n服务在 `GET /.well-known/openai-apps-challenge` 以纯文本原样返回该 token；未配置时\n返回 404。\n\n## 凭证与配置\n\n与本地版相同：使用 `~/.usmart/config.json`（OAuth2 配置），可用 `USMART_HOME` 覆盖目录。\n本发行版不提供本地授权工具，OAuth 授权由远程部署的网关或后续的 broker 完成。\n\n## 与本地交易版的关系\n\n| 发行版 | 入口命令 | 运行形态 | 用途 |\n|---|---|---|---|\n| `usmartsg-mcp` | `usmartsg-mcp` | 默认 `local`，可显式切换 | 本地客户端，可启用真实交易 |\n| `usmartsg-mcp-directory` | `usmartsg-mcp-directory` | 构建期固定 `directory` | 远程只读部署，目录上架 |\n\n两个发行版的顶层 import 包不同（`usmart_mcp` / `usmart_mcp_directory`），可以同时\n安装而不会互相覆盖；但同一个进程里只能运行其中一个。\n\n本发行版采用 [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) 发布，\n许可全文见 [LICENSE](LICENSE)。","publisher":null,"homepage":"https://api-doc.usmart.sg/zh-cn/trade.html","repository":"https://git.yxzq.com/usmart/usmart-mcp","version":"1.0.0","license":null,"protocols":["mcp"],"tags":["mcp","openapi","singapore","trading","usmart"],"pricing":null,"endpoints":[{"url":"pypi:usmartsg-mcp-directory","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.apis","name":"API Access","confidence":1,"provenance":"declared"},{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"},{"slug":"ai.agent-discovery","name":"Agent Discovery","confidence":1,"provenance":"derived"},{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"declared"}],"categories":["ai","data","dev","finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"usmartsg-mcp-directory","registry":"pypi","observedAt":"2026-11-05T22:26:36.754Z","publishedAt":"2026-11-03T11:36:48.067817Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"usmartsg-mcp-directory","url":"https://pypi.org/project/usmartsg-mcp-directory/","firstSeenAt":"2026-11-05T22:26:02.771Z","fetchedAt":"2026-11-05T22:26:02.771Z","normalizedAt":"2026-11-05T22:26:02.771Z"}]},"firstSeenAt":"2026-11-05T22:26:02.771Z","updatedAt":"2026-11-05T22:26:36.754Z"}