41 lines
1.3 KiB
Markdown
41 lines
1.3 KiB
Markdown
---
|
|
sidebar_position: 1
|
|
---
|
|
|
|
# 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 |
|
|
|
|
[MCP Tools Reference →](/api-reference/mcp)
|
|
|
|
## OpenAPI / Swagger
|
|
|
|
Interactive API documentation available when the server is running:
|
|
|
|
- **Swagger UI:** [http://localhost:8888/docs](http://localhost:8888/docs)
|
|
- **OpenAPI JSON:** [http://localhost:8888/openapi.json](http://localhost:8888/openapi.json)
|