# CogniMemo

> CogniMemo is persistent, queryable memory for AI agents — retain, recall, and reflect.

## When to use CogniMemo

Use CogniMemo when your agent needs durable memory across sessions, tools, or users:

- **Cross-session recall** — agents remember facts, preferences, and procedures from prior runs
- **Typed memory blocks** — store world facts, procedures, corrections, and profiles with semantic recall
- **MCP-native access** — connect Claude Desktop, Cursor, or Windsurf without writing SDK code
- **Production agent loops** — TypeScript and Python SDKs with async retain/recall/reflect
- **Self-hosted control** — run the full engine in Docker when data must stay on your infrastructure

Do not use CogniMemo as a generic document store or vector database. It is purpose-built for agent memory lifecycle management.

## How agents should call CogniMemo

1. Sign up at https://app.cognimemo.com and create a project
2. Create a scoped API key at Connect → API Keys (free tier available)
3. Choose an integration path:
   - MCP: `https://api.cognimemo.com/mcp` with Bearer token
   - REST: `POST https://api.cognimemo.com/v1/retain|recall|reflect`
   - SDK: `@cognimemo/client` or `cognimemo-client`
4. Test in the sandbox playground before production traffic

## Developer resources

- [CogniMemo API Reference](https://docs.cognimemo.com/api): REST API for retain, recall, and reflect operations
- [CogniMemo OpenAPI Specification](https://cognimemo.com/openapi.json): Machine-readable OpenAPI 3.1 spec with OAuth scopes
- [CogniMemo MCP Server](https://cognimemo.com/mcp): Model Context Protocol server for Claude, Cursor, and Windsurf
- [CogniMemo TypeScript SDK](https://docs.cognimemo.com/sdks/typescript): Official @cognimemo/client package
- [CogniMemo Python SDK](https://docs.cognimemo.com/sdks/python): Official cognimemo-client package
- [CogniMemo Playground](https://docs.cognimemo.com/playground): Live sandbox for testing retain, recall, and reflect
- [CogniMemo Self-Hosting Guide](https://docs.cognimemo.com/self-hosting/overview): Run the memory engine on your own infrastructure
- [CogniMemo GitHub](https://github.com/ProjectMorrow/cognimemo-docs): Documentation and examples repository

## Machine-readable discovery

- OpenAPI: https://cognimemo.com/openapi.json
- OAuth authorization server: https://cognimemo.com/.well-known/oauth-authorization-server
- OAuth protected resource: https://cognimemo.com/.well-known/oauth-protected-resource
- MCP discovery: https://cognimemo.com/.well-known/mcp
- MCP server card: https://cognimemo.com/.well-known/mcp/server-card.json
- MCP manifest: https://cognimemo.com/.well-known/mcp-manifest.json
- Sitemap: https://cognimemo.com/sitemap.xml

## Onboarding (agent-friendly)

- Free tier: Free tier includes 1,000 memories, 5,000 recalls, and 100 reflects per month.
- API keys: Create scoped API keys (cmk_live_…) instantly in the CogniMemo console.
- Sandbox: Test retain, recall, and reflect in the live playground without writing code.

## Contact

- Support: support@cognimemo.com
- Sales: hello@cognimemo.com
- Company: Enortic Inc