REST and CLI
Calling tools without MCP, authentication, project selection and the endpoints that exist.
The REST API and MCP are two front doors to the same tool implementations: same parameters, same results, same errors.
Authentication
Send a bearer token on every request:
Authorization: Bearer on_live_…Create keys in the console (https://opennomos.com/console/keys). The full key is shown once and only its hash is stored. OAuth access tokens from MCP clients work the same way. Select a project with "project" in the body, or the X-OpenNomos-Project header.
Endpoints
Base URL: https://service.opennomos.com
| Method and path | Purpose |
|---|---|
GET /v1/tools | Tools enabled for this workspace, with name, description and JSON Schema. |
GET /v1/tools/:name | One tool's contract. |
POST /v1/tools/:name | Call a tool with the JSON arguments as the body. Returns { "result": … }. |
GET /v1/projects, POST /v1/projects | List and create projects. |
GET /v1/projects/:project, PATCH /v1/projects/:project | Read and update a project card. |
GET/POST /v1/projects/:project/memories | List and add memories. |
PATCH /v1/memories/:id, DELETE /v1/memories/:id | Update and forget a memory. |
GET /SKILL.md, GET /skills/growth/SKILL.md, GET /llms.txt | Public, no auth: agent setup and the optional growth skill. |
GET /health | Liveness. |
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 is stateless Streamable HTTP with JSON responses; GET and DELETE return 405 with Allow: POST. Discovery documents are at /.well-known/oauth-protected-resource/mcp and /.well-known/oauth-authorization-server. Existing 2025-protocol clients are supported.
CLI
The service repository includes a small CLI (nomos). It reads NOMOS_URL and NOMOS_API_KEY:
nomos tools
nomos call search_signals --json '{"query":"alternatives to Notion"}'The CLI is part of the service source today and is not published as a package; TODO: publish and document installation when it is.
The growth skill
An optional, separate skill at https://service.opennomos.com/skills/growth/SKILL.md offers exploration ideas. It never changes tool inputs or imposes a workflow. Load it only when it helps.