Reference

MCP tool reference

Every registered tool with its required scope, credit cost, and read/write classification — generated from source.

Last updated 2026-07-27

The complete tool registry behind MCP, REST, and the SDK — generated from source so scopes and costs stay exact. Reads cost zero credits; writes are classified and may require confirmation for OAuth agents (see reads vs. writes).

Operator metering narrative: Billing & credits. Wire-up: MCP guide · Quickstart.

Tools

Reads (free)

Writes

context

Tool	Scope	Cost	Description
`context.brief` readSDK	context:read	FREE	Preferred entry point for external agents. Returns a warm, visibility-scoped and source-cited company capsule, including current thesis pillars and open tensions when present. Use lens=handoff for a continuity brief covering responsibilities, commitments, positioning, relationships, and unresolved decisions. Free (0 WU).
`context.correct` writeSDK	context:write	FREE	Correct a cited passage or an unambiguous visible statement. Recording evidence never grants adoption authority; the authenticated connection's existing workspace/team scope controls whether the correction is applied, proposed, ambiguous, or not found.
`context.export` readSDK	context:read	FREE	Download a visibility-scoped markdown repository of maintained Brain pages, a sources index, and current decisions.json. Uses the same read kernel as context.brief. Free (0 WU).
`context.remember` writeSDK	context:write	FREE	Preserve one durable fact, constraint, commitment, correction, session outcome, or explicit open question so future agents start with the same company context. Use kind:"question" only when authoring an open question — never inferred from prose. Requires a caller-stable idempotency_key and returns a truthful write receipt.
`context.resolve` writeSDK	context:write	FREE	Answer a material open_questions[] item from context.brief or context.search. Routes through Track D materialization (correct / observe / resolvePendingJudgment) so the answer changes corpus state. Requires a caller-stable idempotency_key and returns a truthful write receipt.
`context.search` readSDK	context:read	FREE	Search workspace context for source-backed snippets on a topic, or hydrate exact references returned by context.brief. Exact reads support bounded content_offset/content_limit continuation without changing source version or authorization. Returns extractive evidence with resolvable source metadata; it does not generate an answer. Free (0 WU).
`context.source.adopt` writeSDK	context:write	FREE	Adopt an exact, already-authorized document version created by HiveBase's upload path. The operation never fetches a URL, changes source visibility, or substitutes a newer version.
`context.source.ingest` writeSDK	context:write	FREE	Submit exact original source bytes with caller-stable identity, provider ordering, attribution, and access metadata. Generated summaries are not evidence. Returns a durable receipt and makes stale versions visible without rewriting source history.
`context.source.upload` writeSDK	context:write	FREE	Prepare a bounded signed upload for original UTF-8 source bytes, then finalize the exact uploaded bytes into the canonical source/version flow. This never fetches a URL and never changes visibility or adoption authority.
`context.sync` readSDK	context:read	FREE	Return visibility-scoped knowledge, decision, and work references changed since an opaque durable cursor, then issue the next cursor for another agent or session. Free (0 WU).

decision

Tool	Scope	Cost	Description
`decision.record` writeSDK	decision:write	FREE	Record an immutable decision with its context, judgment, rationale, evidence, and optional superseded decision so every future agent can retrieve the current precedent. Visibility defaults to private in a personal workspace and company-wide in a company workspace. Requires a caller-stable idempotency_key and returns a truthful write receipt.
`decision.search` readSDK	decision:read	FREE	Find previous decisions or hydrate known decisions before making a new call. Returns current, visibility-scoped precedent with source references, never invented synthesis. Free (0 WU).

engineering

Tool	Scope	Cost	Description
`engineering.brief` readSDK	engineering:read	FREE	Return the deterministic six-dimension Engineering brief with explicit evidence gaps and at most three prioritized actions.
`engineering.incident.get` readSDK	engineering:read	FREE	Return one Engineering incident with its real event ledger and immutable verification receipts.
`engineering.incidents.list` readSDK	engineering:read	FREE	List company-scoped Engineering incidents with honest resolution disposition and verification receipt linkage.

linear

Tool	Scope	Cost	Description
`linear.issue.title.update` writeSDK	external-action:write	FREE	Propose changing the title of an already-linked Linear issue. Requires exact human approval. Reversible for 24 hours after confirmed application if Linear still shows the applied title.

receipt

Tool	Scope	Cost	Description
`receipt.get` readSDK	context:read	FREE	Read the truthful accepted, processing, applied, failed, rejected, or expired state of a context or decision write and its safe resulting entity reference. Free (0 WU).

task

Tool	Scope	Cost	Description
`task.create` writeSDK	task:write	FREE	Create an idempotent task in the canonical HiveBase work ledger with explicit provenance and return a durable write receipt.
`task.get` readSDK	task:read	FREE	Read one caller-visible HiveBase task from the canonical work ledger using its stable task identifier.
`task.mailbox.read` writeSDK	task:write	FREE	Atomically consume pending human messages for an authorized task, attribute delivery to this credential, and return the messages with a receipt.
`task.needs_you` writeSDK	task:write	FREE	Submit a human-attention request for an authorized task into a quarantined review lane; this never admits the request directly to Focus.
`task.post` writeSDK	task:write	FREE	Append an idempotent progress or final report to a HiveBase task without replacing prior reports or fabricating chat messages.
`task.search` readSDK	task:read	FREE	Search the caller-visible HiveBase work ledger by text, status, or project without exposing private tasks or internal task metadata.
`task.status.set` writeSDK	task:write	FREE	Move an authorized HiveBase task to a canonical workflow status and return a durable, idempotent write receipt.