HTTP API

The Ormah server runs a FastAPI app on localhost:8787. All adapters (MCP, CLI, OpenAI) talk to this server. You can also call it directly.

Base URL

http://localhost:8787

Agent routes

These mirror the 6 MCP tools:

Method	Path	Description
POST	/agent/remember	Store a memory
POST	/agent/recall	Search memories
POST	/agent/recall_node	Get a node by ID
POST	/agent/mark_outdated	Demote a node
POST	/agent/submit_feedback	Submit whisper feedback
POST	/agent/maintenance	Run maintenance (two-phase)
POST	/agent/whisper	Get whisper context for a prompt

Admin routes

GET  /admin/health         — server health check
GET  /admin/tasks          — background job status
POST /admin/rebuild        — rebuild SQLite index from markdown files

Ingest routes

POST /ingest/conversation  — ingest a parsed conversation
POST /ingest/file          — ingest a markdown file

UI routes

GET  /ui                   — graph explorer web UI
GET  /ui/search            — search interface
GET  /ui/insights          — memory stats and insights

Example: store a memory

curl -X POST http://localhost:8787/agent/remember \
  -H "Content-Type: application/json" \
  -d '{"content": "Prefers dark mode in all tools", "type": "preference", "tier": "core"}'

Example: recall

curl -X POST http://localhost:8787/agent/recall \
  -H "Content-Type: application/json" \
  -d '{"query": "UI preferences", "limit": 5}'

---

Full request/response schemas coming soon.