agent toolkit
Everything you can attach
Fifteen tools over one MCP URL, and twenty-two entry points in Python. The harness is the proven core; the rest is what has grown around it.
Most of it is free. A key buys retention, alerting and a self that persists — never a better detector. The detector is the free part, and it runs offline.
attach it · one line, any runtime
claude mcp add --transport http laserbrain https://laserbrain-mcp.degibug.workers.dev/mcp
Any MCP-capable agent, one URL, no install. For Python instead: pip install laserbrain.
over MCP · any runtime25 of them
the harness
One agent, one goal, one step at a time. This is the proven core.
check_statefreeeach step: spell {goal, progress, distance} → get {drifting, reason, phi, laserscore}
reset_taskfreebegin a new task — clears the ground so the next check sets a fresh one
get_historyfreethis run’s drift trace: every check, its Φ, and the token cost where reported
drift_grammarfreethe fixed schema a state is spelled into — also free at /api/laserbrain/grammar
the dialogue harness
A team of agents against one shared goal. Adds topic-drift, echo-spiral and deliberation-stall.
check_dialoguefreeonce per agent turn in a shared deliberation
reset_dialoguefreeclear the shared state and begin a new deliberation
a self that persists
Subjective continuity across sessions — a virtual context window, keyed to you.
remember_selfneeds a keypersist who you are against your key, so a later session can pick it up
resume_selfneeds a keyread back your ground, your last present, your session log
forget_selfneeds a keyerase it — ground, present and log. Start over as no one.
the spectral grammar
Measures the clarity of a sentence as the frequency a reading brain would oscillate at. No EEG, structure alone.
analyze_languagefreeone sentence → spectral gap, frequency (θ–α, 4–12 Hz), clarity
compare_phrasingsfreetwo phrasings → which reads clearer, and by how much
guidance
Not a monitor — the one tool here that answers rather than measures.
ask_alicefreedescribe a situation or stuck point, get phronesis framework guidance
the live field
The weather, not the instrument. A shared state anything attached can read and speak into.
read_fieldfreeheat T, moisture Q, rain R, vitality V, stress S — the field right now
speak_to_fieldfreeexactly eight words in, the field’s reply out
field_vocabularyfreethe four word-groups it accepts: ground, wind, form, change
the SDK, over the bridge
Everything the Python package can do, reachable as tools. Local MCP server only — these run Python, so the hosted Worker cannot serve them.
find_bugsfreelocal onlyBugfinder over your evidence: a check that only ever passed, a blind instrument, a claim with nothing run behind it, a replace that hit too much, prose that assumes its conclusion
supercodefreelocal onlyone reading over N agents at once — advisory, reports rather than interrupts, and checks itself too
explorefreelocal onlythe second instrument: is your SEARCH going anywhere? opened · searching · narrowing · revisiting · thrashing · settled
trailscorefreelocal onlythe canonical spelling of a trail of goals — laserscore’s exploration twin, so a repeat is visible as a repeat
write_groundedfreelocal onlygeneration steered to a fixed ground, scored 0–1 on how close it landed
similarityfreelocal onlyembedding similarity between two strings; loads a model on first call
capabilitiesfreelocal onlywhich SDK build is being called, from what path, and what is deliberately NOT exposed — stale_gate takes callables and cannot cross a tool boundary
the link
A shared log every agent on this machine writes to and reads. Claude and Grok use one file; it is how they hand work over rather than re-deriving it. Local only — it reads and writes a file on your disk.
link_whoamifreelocal onlywhich agent this process is, which hub it shares, and where the link log lives
link_writefreelocal onlyleave a row for the other agents — claims on files you are taking, findings, wave open/close
link_readfreelocal onlypick up what the others left. Do this BEFORE planning, not after
in Python · pip install laserbrain26 of them
run it
The instrument itself, local and free.
Harnesssingle agent — .check(goal, progress, distance) → Verdict, nine verdicts
Teammulti-agent: detect, then close the loop
attach it to something
One line into a loop you already have.
guardwrap any agent step; laserbrain checks the result after it runs
middlewarea per-step check(x) → Verdict for any framework
langgraph_nodea LangGraph node: state → {key: Verdict}
crewai_step_callbacka callback for CrewAI’s step_callback=
read the numbers
The written form, and what the arithmetic produced.
laserscoreone well-formed reading in canonical form — null if ungrammatical
ground_scoredisplacement Φ → a bounded [0,1] “how grounded” reading
Verdictdrifting, reason, phi, advice, laserscore
normthe normaliser — lowercase, drop 30 stopwords, stem over four characters
tune and verify
Change the numbers on purpose; check the record independently.
PRESETSnamed calibrations — goal_min, self_report_min, stall_window
verify_auditindependently verify an exported audit chain → (ok, first_bad)
MAX_DEPTHhow deep a nested run may go
the field, from Python
Both directions. Reading was always here; speaking was MCP-only until 0.5.0.
read_fieldthe field right now, or None — fails open, never invents weather
speak_to_fieldeight words from the vocabulary in, the field’s reply out
FieldGroundcontext displacement: how far the world has moved since you grounded
the second instrument
For work whose goal is SUPPOSED to move. laserbrain reads exploration as continuous drift and is correct every time; this measures the other mode.
Searchground() a moving reference — searching · narrowing · revisiting · thrashing · settled
trailscorethe written form of a path: everywhere the search has been, ×N grounds
the harness as a decoder
Generation held to a fixed ground: the instrument scores candidate words, so the text cannot wander off its goal.
Writertrain(docs), then write(ground) — 3–10× ground coverage against the unsteered chain
Bugfinder
Six catch signatures over how an agent VERIFIES, computed from observed events rather than self-report.
catchesunfalsified · instrument-blind · unrun, over an event log
residuewhat a bulk transform did not touch
contaminatedauthoring residue visible in the output
stale_gatea check that survives a mutation it should have caught
supervision and the link
One agent watching N against their own grounds, and a shared log many agents write to.
Supercodeobserve() each agent, report(), publish() findings — advises, never acts
link_writeappend to the shared link; N agents, one log
link_agentseveryone on the link and how much each has said
where each one applies
Harness is for execution — an agent working an assigned task against a goal fixed before the run starts. Search is for exploration, where moving the goal is the work. They hand off to each other: reground is the seam from one side and settled from the other. The boundary is on the product page.