参考
REST 与 CLI
不用 MCP 直接调用工具：认证、项目选择，以及现有的端点。
REST API 和 MCP 是同一套工具实现的两个入口：参数、结果、错误都一样。
认证
每个请求都带上 Bearer 令牌：
Authorization: Bearer on_live_…密钥在控制台创建（https://tools.opennomos.com/console/keys）。完整密钥只显示一次，服务端只存哈希。MCP 客户端拿到的 OAuth 访问令牌用法相同。用请求体里的 "project" 或 X-OpenNomos-Project 请求头选择项目。
端点
基础 URL:https://service.opennomos.com
| 方法和路径 | 用途 |
|---|---|
GET /v1/tools | 该工作区已启用的工具，带名称、描述和 JSON Schema。 |
GET /v1/tools/:name | 单个工具的契约。 |
POST /v1/tools/:name | 调用工具，JSON 参数放在请求体里。返回 { "result": … }。 |
GET /v1/projects、POST /v1/projects | 列出和创建项目。 |
GET /v1/projects/:project、PATCH /v1/projects/:project | 读取和更新项目卡片。 |
GET/POST /v1/projects/:project/memories | 列出和添加记忆。 |
PATCH /v1/memories/:id、DELETE /v1/memories/:id | 更新和忘掉一条记忆。 |
GET /SKILL.md、GET /skills/growth/SKILL.md、GET /llms.txt | 公开，无需认证：agent 接入说明和可选的增长 skill。 |
GET /health | 存活检查。 |
curl https://service.opennomos.com/v1/tools/discover_tools -X POST \
-H "Authorization: Bearer $OPENNOMOS_API_KEY" -H "content-type: application/json" -d '{}'MCP
POST https://mcp.opennomos.com/mcp 是无状态的 Streamable HTTP，返回 JSON;GET 和 DELETE 返回 405 并带 Allow: POST。发现文档在 /.well-known/oauth-protected-resource/mcp 和 /.well-known/oauth-authorization-server。已有的 2025 版协议客户端也受支持。
CLI
服务仓库里带一个小 CLI（nomos）。它读取 NOMOS_URL 和 NOMOS_API_KEY:
nomos tools
nomos call search_signals --json '{"query":"alternatives to Notion"}'目前 CLI 只在服务源码里，还没有作为包发布；TODO：发布后补上安装说明。
增长 skill
另有一个可选的独立 skill，地址是 https://service.opennomos.com/skills/growth/SKILL.md，提供一些探索思路。它不会改变工具的输入，也不会强加流程。需要时再加载。