# RJ Knowledge Graph

> Edge-native knowledge graph + multi-tier memory system for AI agents.
> Persistent memory (episodic/semantic/procedural), agent namespaces, Graph-RAG Q&A,
> semantic search via Cloudflare Workers AI embeddings. Zero infrastructure.
> By RJ Business Solutions — https://rjbusinesssolutions.org

Base URL: https://rj-knowledge-graph.pages.dev
Auth: x-api-key header (optional — demo tier without it; free key: POST /api/billing/keys)

## MCP (recommended for agents)
- Endpoint: POST https://rj-knowledge-graph.pages.dev/mcp (JSON-RPC 2.0, Streamable HTTP)
- Connect: npx mcp-remote https://rj-knowledge-graph.pages.dev/mcp
- Tools: remember, recall, ask_graph, search_graph, find_path, ingest_document, graph_overview

## Core REST endpoints
- POST /api/memory/remember: store memory {content, context?, tier?, importance?, agent_id?, namespace?}
- POST /api/memory/recall: retrieve memories {query, top_k?, agent_id?, namespace?} — hybrid vector+recency+importance scoring
- POST /api/ask: Graph-RAG Q&A {question}
- POST /api/ingest: add document {path, content} — entities/relationships auto-extracted
- GET /api/search?q=: keyword search
- GET /api/search/semantic?q=: vector search
- GET /api/graph?limit=: graph nodes+links
- GET /api/graph/path?from=&to=: shortest path between entities
- GET /api/agents: agent registry
- POST /api/billing/keys: self-serve API key {owner_name, owner_email?, tier: "free"}
- GET /api/system/status: capabilities

## Docs
- Human docs: https://rj-knowledge-graph.pages.dev/docs
- OpenAPI 3.1: https://rj-knowledge-graph.pages.dev/api/openapi.json
- Pricing: free $0/1K calls · pro $49/50K · enterprise $499/1M per month