Tool reference
Most sessions only ever need get_context. The rest are there when an agent wants to write something back, walk the graph, show provenance, or draft an action.
Context
What an agent calls to start work already knowing your team.
get_contextCompressed team context relevant to the current task. The one call worth making at the start of anything non-trivial.
search_memorySearch the graph for specific facts and get raw results back — filterable by entity or by date.
get_team_memberEverything Flipper knows about one person, by name or email.
get_playbookHow your company actually performs a process — refunds, escalations, onboarding. Distilled from your own facts, and only served once a human has approved it.
searchThe ChatGPT connector's search shape: results with ids to pass to fetch. Same retrieval as search_memory.
fetchThe ChatGPT connector's companion: full text and sources for one fact id.
Write-back
How an agent (or you) puts something back into the brain.
record_decisionRecord a decision or insight in prose; Flipper synthesizes it into facts like any other source.
record_factWrite one structured subject–predicate–object fact directly, skipping synthesis.
correct_factSupersede a wrong value. The old fact is invalidated and kept, never deleted.
forget_factSoft-delete a fact: hidden everywhere immediately, purged after 30 days.
set_sensitivityChange who can see a fact — public, confidential, or personal to its creator.
Entities & graph
Navigating people, projects and the typed edges between facts.
get_entityOverview of any entity: canonical name, type, aliases, fact counts, recent facts.
list_entitiesBrowse the entity registry, optionally by type.
add_aliasTeach Flipper that a nickname or handle refers to an entity it already knows.
merge_entitiesMerge a duplicate into the entity that should survive; every fact repoints. Admins only.
get_relatedFacts connected through typed edges — what a fact derives from, supports, or contradicts.
Catch-up & provenance
What changed while you were away, and why Flipper believes a fact.
what_changed_sinceFacts introduced or superseded since a timestamp — the after-vacation call.
get_recent_decisionsDecisions recorded in the last N days (30 by default).
get_entity_timelineOne entity's history in order, superseded facts included.
get_fact_sourcesThe source episodes behind a fact, with raw text when it was stored.
get_fact_historyThe supersession chain: how a claim changed over time, and when.
get_contradictionsWhat disagrees with a fact — what it replaced, what replaced it, what stands in tension with it, and who asserted each side.
The agent loop
Drafting an action from what the company knows — and telling Flipper whether it worked.
propose_actionA source-cited draft of the action you asked for, built from your own facts and approved playbooks. Flipper never sends it — your agent executes it under its own credentials.
record_outcomeTell Flipper whether a draft or playbook actually worked. Cited facts move by one bounded step, so confidence tracks usefulness rather than assertion.