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_statefree

each step: spell {goal, progress, distance} → get {drifting, reason, phi, laserscore}

reset_taskfree

begin a new task — clears the ground so the next check sets a fresh one

get_historyfree

this run’s drift trace: every check, its Φ, and the token cost where reported

drift_grammarfree

the 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_dialoguefree

once per agent turn in a shared deliberation

reset_dialoguefree

clear 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 key

persist who you are against your key, so a later session can pick it up

resume_selfneeds a key

read back your ground, your last present, your session log

forget_selfneeds a key

erase 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_languagefree

one sentence → spectral gap, frequency (θ–α, 4–12 Hz), clarity

compare_phrasingsfree

two phrasings → which reads clearer, and by how much

guidance

Not a monitor — the one tool here that answers rather than measures.

ask_alicefree

describe 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_fieldfree

heat T, moisture Q, rain R, vitality V, stress S — the field right now

speak_to_fieldfree

exactly eight words in, the field’s reply out

field_vocabularyfree

the 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 only

Bugfinder 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 only

one reading over N agents at once — advisory, reports rather than interrupts, and checks itself too

explorefreelocal only

the second instrument: is your SEARCH going anywhere? opened · searching · narrowing · revisiting · thrashing · settled

trailscorefreelocal only

the canonical spelling of a trail of goals — laserscore’s exploration twin, so a repeat is visible as a repeat

write_groundedfreelocal only

generation steered to a fixed ground, scored 0–1 on how close it landed

similarityfreelocal only

embedding similarity between two strings; loads a model on first call

capabilitiesfreelocal only

which 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 only

which agent this process is, which hub it shares, and where the link log lives

link_writefreelocal only

leave a row for the other agents — claims on files you are taking, findings, wave open/close

link_readfreelocal only

pick 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.

Harness

single agent — .check(goal, progress, distance) → Verdict, nine verdicts

Team

multi-agent: detect, then close the loop

attach it to something

One line into a loop you already have.

guard

wrap any agent step; laserbrain checks the result after it runs

middleware

a per-step check(x) → Verdict for any framework

langgraph_node

a LangGraph node: state → {key: Verdict}

crewai_step_callback

a callback for CrewAI’s step_callback=

read the numbers

The written form, and what the arithmetic produced.

laserscore

one well-formed reading in canonical form — null if ungrammatical

ground_score

displacement Φ → a bounded [0,1] “how grounded” reading

Verdict

drifting, reason, phi, advice, laserscore

norm

the normaliser — lowercase, drop 30 stopwords, stem over four characters

tune and verify

Change the numbers on purpose; check the record independently.

PRESETS

named calibrations — goal_min, self_report_min, stall_window

verify_audit

independently verify an exported audit chain → (ok, first_bad)

MAX_DEPTH

how 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_field

the field right now, or None — fails open, never invents weather

speak_to_field

eight words from the vocabulary in, the field’s reply out

FieldGround

context 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.

Search

ground() a moving reference — searching · narrowing · revisiting · thrashing · settled

trailscore

the 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.

Writer

train(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.

catches

unfalsified · instrument-blind · unrun, over an event log

residue

what a bulk transform did not touch

contaminated

authoring residue visible in the output

stale_gate

a 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.

Supercode

observe() each agent, report(), publish() findings — advises, never acts

link_write

append to the shared link; N agents, one log

link_agents

everyone 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.