Binaly
How it works Pricing Docs Sign in Start free
Binaly
Start free
DOCS  /  REFERENCE / TOOL SURFACE
Search the docs
REFERENCE / TOOL SURFACE

Tool surface

Binaly is a remote MCP server, and everything your AI assistant does runs through a fixed set of tools. You’ll never call these directly – your AI assistant does – but knowing what’s available is useful if you want to understand what a given request is doing.

Reading the graph

note_query

Search notes by type, field values (including numeric comparisons like “deposited above 675°C”), or what’s missing.

note_get & note_context

A single note by id, or a note plus everything connected to it in one call – the second is what your AI assistant uses to reason about a thing in context.

provenance & schema_describe

The real source file a note was extracted from, and the note types, required fields, and what each type checks for.

Writing to the graph

note_create and note_update create or edit a note. Every write returns a list of gaps – what’s still missing – rather than silently accepting an incomplete record as final; see Schemas and gaps.

Ingesting source material

Files arrive through Binaly Sync, which uploads them to your lab’s storage itself. Processing is the hourly scheduled task in Claude Desktop (see Set up Binaly): each run calls ingest_next, which hands it the next files Sync sent and says what to do with each, until the batch is done.

ingest_plan, ingest_check and ingest_record handle the bookkeeping around each file – planning what to do with it, checking whether it’s already handled, recording the outcome. blob_get re-reads an original source file behind a note – see Ingest and checksums.

ON THIS PAGE
Something unclear? Ask us – we answer properly.

Tool surface

Everything your AI assistant does runs through a fixed set of tools. You’ll never call these directly, but knowing what’s available is useful.

Reading the graph

note_query

Search notes by type, field values, or what’s missing.

note_get & note_context

A single note, or a note plus everything connected to it.

provenance & schema_describe

The real source file behind a note, and each type’s schema.

Writing to the graph

note_create and note_update create or edit a note. Every write returns a list of gaps rather than silently treating an incomplete record as final.

Ingesting source material

Binaly Sync uploads the files; the hourly processing task in Claude Desktop calls ingest_next for the next files to read. ingest_plan/check/record keep the bookkeeping per file. blob_get re-reads an original file behind a note.

PREVIOUS
Capture rituals
NEXT
Schemas and gaps

See it on your own folders.

Thirty days free. Connect your AI assistant, install Binaly Sync, and choose your own folders.

Start free

See it on your own folders.

Thirty days free. Connect your AI assistant, install Binaly Sync, and choose your own folders.

Start free