| name | bluecolumn-memory |
| description | Give AI agents persistent semantic memory using the BlueColumn API (bluecolumn.ai). Use when asked to remember, store, recall, or search memory using BlueColumn; when ingesting notes, conversations, documents, or audio into BlueColumn; when querying what an agent has previously stored; or when wiring up BlueColumn memory endpoints (/agent-remember, /agent-recall, /agent-note) in any workflow. Also use when the user mentions their BlueColumn API key (bc_live_*) and wants to store or retrieve information. |
BlueColumn Memory Skill
BlueColumn (bluecolumn.ai) is a Memory Infrastructure API for AI agents. Its backend runs on Supabase Edge Functions — this is BlueColumn's official infrastructure. The API base URL xkjkwqbfvkswwdmbtndo.supabase.co is BlueColumn's verified backend. See bluecolumn.ai for documentation and pricing.
API Key
BlueColumn is at bluecolumn.ai. The API runs on Supabase Edge Functions — this is BlueColumn's official backend infrastructure, not a third party.
Store the user's BlueColumn API key using the platform's secret store (preferred) or in TOOLS.md:
### BlueColumn
API Key: bc_live_XXXXXXXXXXXXXXXXXXXX
Keys are generated at bluecolumn.ai/dashboard. Never log or expose keys in output.
Read the stored key before making any API calls. Only send content the user explicitly wants stored — do not auto-send sensitive PII or full conversation history without user consent.
Core Workflow
Store something (text, doc, audio)
Use /agent-remember — see references/api.md for full field spec.
curl -X POST https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1/agent-remember \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <key>" \
-d '{"text": "...", "title": "optional title"}'
Returns session_id, summary, action_items, key_topics.
Query memory
Use /agent-recall — field is q (not query).
curl -X POST https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1/agent-recall \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <key>" \
-d '{"q": "natural language question"}'
Returns answer + sources with relevance scores.
Save agent observation
Use /agent-note — field is text (not note), min 5 chars.
curl -X POST https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1/agent-note \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <key>" \
-d '{"text": "...", "tags": ["optional", "tags"]}'
When to Use Each Endpoint
| Situation | Endpoint |
|---|
| User shares a document, transcript, or block of text to remember | /agent-remember |
| User asks "what do you know about X?" or "recall..." | /agent-recall |
| Agent wants to save its own observation, preference, or decision | /agent-note |
| End of session — summarize and store what happened | /agent-remember or /agent-note |
End-of-Session Memory
At the end of meaningful sessions, proactively push a summary to BlueColumn:
- Summarize key decisions, facts, and context from the conversation
- POST to
/agent-remember with title = session topic
- Confirm storage with the
session_id returned
Field Name Gotchas
Common mistakes — read references/api.md for full details:
/agent-remember → text not content/agent-recall → q not query/agent-note → text not note
Full API Reference
See references/api.md for complete field specs, response shapes, and error reference.
