API Reference
Complete reference for Hindsight's HTTP and MCP APIs.
HTTP API
The HTTP API reference is automatically generated from our OpenAPI specification. Browse the endpoints in the sidebar to see request/response details, parameters, and examples.
Base URL: http://localhost:8888
| Category | Endpoints |
|---|---|
| Memory Operations | Store, search, list, delete memories |
| Reasoning | Think and generate personality-aware responses |
| Memory bank Management | Create, update, list memory banks and profiles |
| Documents | Manage document groupings |
| Visualization | Get entity graph data |
MCP API
The MCP (Model Context Protocol) API exposes Hindsight tools for AI assistants like Claude Desktop.
| Tool | Description |
|---|---|
hindsight_search | Search memories |
hindsight_think | Generate personality-aware response |
hindsight_store | Store new memory |
hindsight_agents | List available memory banks |
OpenAPI / Swagger
Interactive API documentation available when the server is running:
- Swagger UI: http://localhost:8888/docs
- OpenAPI JSON: http://localhost:8888/openapi.json