Getting Started

Give your AI agent persistent memory in under 60 seconds. Three API calls is all it takes.

Your API Key

Loading... Click to copy

Base URL

All API requests go to:

https://hom-brain-api-860389503600.us-central1.run.app

Every request requires your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY
Step 1

Save a Memory

Store knowledge that your AI agent can recall later. Every memory gets a key and a value.

JavaScript
Python
cURL
JavaScript 
const res = await fetch('https://hom-brain-api-860389503600.us-central1.run.app/oracle/save', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    key: 'client_sarah',
    value: 'Prefers monthly billing. Budget approved for Q2.'
  })
});

const data = await res.json();
console.log(data); // { success: true, id: "..." }
Python 
import requests

res = requests.post(
    'https://hom-brain-api-860389503600.us-central1.run.app/oracle/save',
    headers={'Authorization': f'Bearer {API_KEY}'},
    json={
        'key': 'client_sarah',
        'value': 'Prefers monthly billing. Budget approved for Q2.'
    }
)

print(res.json())  # {'success': True, 'id': '...'}
cURL 
curl -X POST https://hom-brain-api-860389503600.us-central1.run.app/oracle/save \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key":"client_sarah","value":"Prefers monthly billing. Budget approved for Q2."}'
Response
{
  "success": true,
  "id": "a1b2c3d4-e5f6-...",
  "key": "client_sarah"
}
Step 2

Recall Knowledge

Query your brain with natural language. HOM finds the most relevant memories using semantic search.

JavaScript
Python
cURL
JavaScript 
const res = await fetch(
  'https://hom-brain-api-860389503600.us-central1.run.app/oracle/recall?q=sarah+billing',
  { headers: { 'Authorization': `Bearer ${API_KEY}` } }
);

const data = await res.json();
console.log(data.results[0].value);
// "Prefers monthly billing. Budget approved for Q2."
Python 
res = requests.get(
    'https://hom-brain-api-860389503600.us-central1.run.app/oracle/recall',
    headers={'Authorization': f'Bearer {API_KEY}'},
    params={'q': 'sarah billing', 'limit': 5}
)

for memory in res.json()['results']:
    print(memory['key'], '-', memory['value'])
cURL 
curl "https://hom-brain-api-860389503600.us-central1.run.app/oracle/recall?q=sarah+billing&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "results": [
    {
      "key": "client_sarah",
      "value": "Prefers monthly billing. Budget approved for Q2.",
      "similarity": 0.94,
      "created_at": "2026-03-19T..."
    }
  ]
}
Step 3

Check Your Brain

See how many memories you've stored, your tier, and usage limits.

cURL 
curl https://hom-brain-api-860389503600.us-central1.run.app/customer/status \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "email": "you@company.com",
  "tier": "founder",
  "status": "active",
  "memories_used": 1,
  "memory_limit": 1000,
  "rate_limit_per_min": 60,
  "member_since": "2026-03-19T..."
}

API Reference

Full list of available endpoints.

Endpoint Description
POST/oracle/save Save a memory (key + value)
GET/oracle/recall?q=... Semantic search across your memories
GET/oracle/status Brain connection status + memory count
GET/customer/status Your account tier, limits, and usage
POST/oracle/log-event Log a structured event to your timeline
GET/oracle/events/today All events logged today

Save Parameters

Optional fields you can pass when saving a memory.

Field Description
key Unique identifier for this memory (required)
value The content to remember (required)
memory_type Category: event_log, procedural, declarative, etc.
scope Visibility: agent, team, or system
source Where this knowledge came from
is_correction true if this updates/corrects a previous memory

Recall Parameters

Param Description
q Search query (semantic, not keyword)
limit Max results (default 10, max 200)
memory_type_filter Filter by type (e.g. event_log, procedural)

Claude Code Integration

Zero-config persistent memory for Claude Code. One line in your config, four tools available instantly.

.claude/mcp.json 
{
  "mcpServers": {
    "hom": {
      "command": "npx",
      "args": ["hom-mcp-server"],
      "env": { "HOM_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Your Claude agent gets 4 tools automatically:

Tool What it does
oracle_status Check brain connection and memory count
oracle_recall Query memories by meaning (semantic search)
oracle_save Store new memories permanently
oracle_log_event Log actions to your timeline

Package on npm: hom-mcp-server

NEED HELP?

Email us at info@hom.autos and we'll get you running.