search_brain is almost always
the first call — it is the fastest way in, and it is what an assistant is told to reach
for before writing anything.
What each of these concepts is →
The descriptions below are quoted verbatim from what the server sends a connected
assistant, which is why they address it rather than you. They are reproduced rather than
rewritten so this page cannot drift from what your assistant actually receives.
search_brain
Search the brain
Ranked keyword search across everything the user has written about themselves: role brain dumps, achievement highlights, notes, projects and their profile. This is the FIRST tool to call when tailoring a resume or answering a question about their experience. Returns excerpts with the id and kind of each hit so you can fetch the full record.
get_brain_snapshot
Get the whole brain
Returns EVERYTHING in the knowledge base at once: profile, all roles with their full brain dumps, all highlights, education, projects, skills, certifications and notes. Use when you need complete context (e.g. writing a resume from scratch). Can be large — prefer search_brain for targeted lookups.
get_profile
Get profile
The user’s identity block: name, headline, contact details, links, career summary and their personal brain dump (values, what they want next, comp expectations, non-negotiables). hasPhoto says whether a profile photo is set; the picture itself is not returned because it is hundreds of kilobytes of base64 — use set_profile_photo to change it.
No arguments.
update_profile
Update profile
Update any subset of the user’s profile fields. Only pass the fields you want to change; omitted fields are left untouched.
Overwrites or deletes.
set_profile_photo
Set the profile photo
Give the user a headshot, or remove the one they have. One picture serves the whole app: it is their avatar in the interface, and every resume whose design has the photo switched on renders this exact image — so replacing it here updates every document at once, and there is never a second copy to keep in sync. Pass url for a picture that already exists on the web (an https link to a JPEG, PNG or WebP — a GitHub avatar, a personal site) and the server fetches it. Pass data_uri when you actually hold the bytes, e.g. after reading a local file: ‘data:image/jpeg;base64,…’. Pass remove: true to clear it. Anything over 400KB is refused, so downscale first — a resume prints the photo about an inch square and a 512px original is already more than that needs. Turning the photo ON for a given resume is a separate step: update_resume with showPhoto: true. Never invent a picture of somebody: use only a URL or file the user has given you.
Overwrites or deletes. Reaches outside this instance.
list_roles
List roles
List every job/role in the knowledge base with dates and how many highlights each has. Does not include the full brain dump — use get_role for that.
No arguments.
get_role
Get a role
Full detail for one role including its complete brain dump text and all of its achievement highlights.
create_role
Create a role
Add a job to the knowledge base. Put every raw detail you were given into brainDump — it is unlimited and is the raw material for future resumes.
update_role
Update a role
Update fields on an existing role. WARNING: passing brainDump REPLACES the whole dump — use append_role_brain_dump to add to it safely.
Overwrites or deletes.
append_role_brain_dump
Append to a role’s brain dump
Safely ADD text to the end of a role’s brain dump without touching what is already there. This is the right tool when the user tells you something new about a job they already have on file.
delete_role
Delete a role
Permanently delete a role and all of its highlights.
Overwrites or deletes.
list_highlights
List highlights
Reusable, polished achievement bullets, strongest first. These are the distilled lines you pull from when assembling a resume.
create_highlights
Create highlights
Distil raw brain-dump material into one or more reusable achievement bullets. Write them in resume voice: strong verb, specific scope, quantified outcome. Create several at once.
update_highlight
Update a highlight
Edit or archive one achievement bullet.
Overwrites or deletes.
delete_highlight
Delete a highlight
Permanently delete an achievement bullet.
Overwrites or deletes.
list_notes
List notes
Free-floating notes not tied to any single job: STAR stories, interview prep, references, compensation history, anything.
No arguments.
create_note
Create a note
Save a free-floating note. Use this for brain-dump material that does not belong to one specific job. Set kind: GUARDRAIL to make it a standing rule instead — see the kind field.
update_note
Update a note
Edit an existing note. Passing body replaces the whole body. Promote a note to a standing rule, or demote one, with kind.
Overwrites or deletes.
list_extras
List education / projects / skills / certifications
Read one of the supporting knowledge-base collections: education history, side projects, skill groups, or certifications.
create_extra
Add education / project / skill group / certification
Add an item to one of the supporting collections. Only the fields relevant to kind are read — see each field’s description for which kind it belongs to.
update_extra
Update an education / project / skill group / certification
Change fields on an item in one of the supporting collections. Reach for this instead of deleting and re-creating — that would hand the item a new id and break anything referring to it. Only the fields you pass are changed; everything you leave out keeps its current value, so you do not need to read the item first. Fields not relevant to kind are ignored.
Overwrites or deletes.