WarmHub

Get organization metadata by name.

warmhub_org_get

Get repo metadata by org and repo name.

warmhub_repo_get

Fetch repo content by kind: readme, agents, or llms-txt (synthesized sitemap).

warmhub_repo_content_get

Return a structured overview of MCP tools by category, common workflows (cookbook), query-discipline guidance (usagePatterns), wref syntax, and a pointer to the full write operation contract. No arguments. See: docs.warmhub.ai/agent-integration/mcp-tools-reference

warmhub_capabilities

Get a shape by name. Response includes queryHints with suggested MCP query patterns for that shape. A composite shape also carries composition: each composed shape's wref and fields, omitted when you cannot read every composed shape. See: docs.warmhub.ai/data-modeling/shapes

warmhub_shape_get

Get subscription metadata by name. Operation subscriptions include immutable effective-source when currently visible, revision/lifecycle, matcher version/digest, credential generation, delivery policy, and retirement audit metadata when applicable. Repo scope is the default and requires repoName; pass scope: 'org' to address an organization subscription.

warmhub_subscription_get

List version history for a thing. Provide wref for one thing's history, or shape/about to survey history across matching things. orgName/repoName are required EXCEPT when wref is a self-routing durable ID; shape/about filter surveys and local wrefs always need orgName/repoName (a repo-less filter query is rejected). With about filters, resolveCollections:true includes history for assertions about collection things and legacy Triple rows containing the target identity; pinned @vN about inputs still resolve that target identity for history filtering. See: docs.warmhub.ai/queries/filtering#version-history

warmhub_thing_history

Fetch one or more things by wref in one call — pass all needed wrefs together rather than calling repeatedly. A wref that does not exist or is not visible to you is listed in "missing", not returned as an error. Pass includeRetracted: true to retrieve retracted versions. Pass dataMode:"full" to force large collection bodies. orgName and repoName may be omitted when every wref is a durable ID or canonical (wh:org/repo/...). See: docs.warmhub.ai/queries/filtering#get-by-wref

warmhub_thing_get

Install a registered component (<org>/<name>) into a target repo: applies its manifest (shapes, credential sets, subscriptions, seeds) and runs the optional setup handshake. Resource-phase failures roll back and throw CONFLICT. A replay of a historical install may return a degraded result with errors[]; callers must check a returned result's state.

warmhub_component_install

List assertions whose about target resolves to the supplied target identity, including thing wrefs (name) and shape wrefs (hub/shapes/<Name>); collection member refs are not expanded by default. For identity-scoped inputs (bare, @HEAD, @ALL), assertions about collection things and legacy Triple rows containing the target require resolveCollections:true; pinned @vN inputs stay version-exact and do not expand collections. For broader backlink discovery, use warmhub_thing_refs with direction:"inbound". For cross-repo targets pass a canonical wref (wh:org/repo/name or wh:org/repo/hub/shapes/<Name>). Any returned subjective-logic opinion (b, d, u, α) is a binomial opinion and is well-formed only when the underlying assertion expresses a binary proposition (true/false). See: docs.warmhub.ai/queries/filtering#about-queries

warmhub_thing_about

List collection members with stable indexes and pagination. orgName and repoName may be omitted when wref is a self-routing durable ID. A Thing may compose more than one collection Shape; pass shape to say which one to read, and omit it when it composes exactly one.

warmhub_collection_members

Get attempt history for one delivery run of a subscription. Full-repository readers may receive free-form diagnostic text; narrowed readers receive stable attempt metadata only.

warmhub_subscription_attempts

List a repository's subscription delivery runs as a page (returns `items` plus an optional `nextCursor`; pass `cursor` to fetch the next page). Filter by exact run id, subscription name, status, outcome (`succeeded`, or `failed` = terminal failures), and lower-bound timestamp. These are webhook delivery executions; for application-level round or session containers modeled as things, use `warmhub_thing_query` with a shape filter instead.

warmhub_subscription_runs

List repo-scoped action notifications for the authenticated user (mirrors `wh notifications`).

warmhub_notifications

List members of an organization.

warmhub_org_member_list

List organizations visible to the current caller.

warmhub_org_list

List repos in an organization.

warmhub_repo_list

List shapes in a repo. Each item includes queryHints with suggested MCP query patterns for that shape. A composite shape also carries composition: each composed shape's wref and fields, omitted when you cannot read every composed shape. See: docs.warmhub.ai/data-modeling/shapes

warmhub_shape_list

List non-retired subscriptions; paused subscriptions remain listed. Operation subscriptions include immutable effective-source when currently visible, revision, matcher, credential generation, and delivery policy. Repo scope is the default and requires repoName; pass scope: 'org' to address an organization subscription.

warmhub_subscription_list

List inbound or outbound refs for a target wref. Use direction:"inbound" to find what references X. Pair with warmhub_thing_get to resolve details. See: docs.warmhub.ai/data-modeling/things

warmhub_thing_refs

List or count items at HEAD with optional filters. For an incremental scan, send sinceRepoSeq (-1 to seed), follow every nextCursor with the same lower bound and limit, and save repoSeq only from the exhausted final page or exact count. Requires full-repository read authority and an authoritative PostgreSQL plan. For fuzzy lookups use warmhub_thing_search. CLI: wh thing list. See: docs.warmhub.ai/queries/head

warmhub_thing_head

Pause an active subscription. Repo scope is the default and requires repoName; pass scope: 'org' to address an organization subscription.

warmhub_subscription_pause

Query or count things by structured filters. For an incremental scan, send sinceRepoSeq (-1 to seed), follow every nextCursor with the same lower bound and limit, and save repoSeq only from the exhausted final page or exact count. Requires full-repository read authority and an authoritative PostgreSQL plan; glob, collection-expanded, and foreign-source forms are unavailable. For fuzzy or semantic search use warmhub_thing_search. See: docs.warmhub.ai/queries/filtering#query-by-filters

warmhub_thing_query

Permanently delete one Thing and all its versions. This cannot be undone; to withdraw a Thing and keep its history, retract it with warmhub_commit_submit instead. Name the Thing by its durable ID (metadata.durableId from a read), never a wref. Needs an unrestricted things:delete grant. References to the Thing survive as its durable ID. Pass expectedVersion to fail if the Thing changed since you read it; without it, the current version is used. Supply a new eventRequestId UUID per removal, and reuse it to retry an ambiguous outcome.

warmhub_thing_remove

Resume a paused subscription. Repo scope is the default and requires repoName; pass scope: 'org' to address an organization subscription.

warmhub_subscription_resume

Revise a named collection by replacement, set delta, or selector-backed replacement.

warmhub_collection_revise

Replace the body of one exact version of a Thing in place, to correct bad data. The version number does not change and no new version is created; to record a new state, revise with warmhub_commit_submit instead. Name the Thing by its durable ID (metadata.durableId from a read), never a wref, and pass the version to correct. `shapes` is the version's declared Shapes plus CorrectedThing, the correction marker. `data` is the complete replacement body, validated against those Shapes: keep every earlier correctionLog entry and append one {reason}. Needs an unrestricted things:rewrite grant. A body with the version's current hash is a noop. Supply a new eventRequestId UUID per rewrite, and reuse it to retry an ambiguous outcome.

warmhub_thing_rewrite

Run WarmHub connectivity and capability diagnostics (mirrors `wh doctor`). Returns server capabilities and a health probe.

warmhub_doctor

Scaffold write-ops JSON for one or more shapes. Returns a ready-to-edit operations array suitable for warmhub_commit_submit. Pass shapeName(s) as a comma-separated list. See: docs.warmhub.ai/writes/operations#generating-templates

warmhub_shape_template

Full-text/vector/hybrid search across thing data. Best for fuzzy lookups; for exact field matches use warmhub_thing_query with a glob filter. See: docs.warmhub.ai/queries/filtering#search

warmhub_thing_search

Set repo content by kind (commits a revise op). Note: --kind llms-txt is read-only and will error.

warmhub_repo_content_set

Submit up to 10000 add/revise/retract/reaffirm/rename operations to a repo. The operations schema contains every supported variant and each operation reports its own result. Example add: {operation:"add", kind:"thing", name:"Signal/example", data:{value:1}}. Use warmhub_repo_describe.commitContract for repo-specific shape fields and examples, and CLI or SDK streaming for larger bulk writes. Include componentRef (the installed component's `Org/Name`) only when intentionally targeting an installed component scope; normal callers should omit it. When writing an assertion that carries a subjective-logic opinion (b, d, u, α): the assertion must express a binary proposition (a statement that is either true or false) — the opinion tuple is a binomial opinion and is meaningless on open-ended claims. See: docs.warmhub.ai/writes/operations

warmhub_commit_submit

Get one thing and its embedded assertion/about/wref graph to a bounded depth. orgName and repoName may be omitted when wref is a durable ID. See: docs.warmhub.ai/data-modeling/things

warmhub_thing_graph

Uninstall a registered component (<org>/<name>) from a repo: pauses its subscriptions, revokes its tokens, dispatches the optional uninstall callback, and marks the install record uninstalled. Non-destructive — manifest shapes and seeded data are left intact; reinstall revives the install. CLI: wh component teardown.

warmhub_component_uninstall

Patch only the provided fields of an existing subscription; omitted fields are preserved and name/kind/eventType cannot change. shapeName and filterJson are commit-only, must agree on shape, and cannot be changed on metadata-event or cross-repo subscriptions, and are rejected outright under scope: 'org'. Example filter replacement: {"all":[{"operation":"revise"},{"kind":"thing"}]}. Repo scope is the default and requires repoName; pass scope: 'org' to address an organization subscription.

warmhub_subscription_update

Evaluate up to 10000 add/revise/retract/restore/reaffirm/rename operations with the real commit evaluator without persisting repository state, consuming a receipt, or dispatching actions. Returns one ordered result per input operation. MCP requests remain subject to the 1 MiB route limit; use the CLI or an SDK for larger previews. Requires write authority even though it is read-only. CLI: wh commit submit --dry-run. See: docs.warmhub.ai/writes/operations

warmhub_commit_validate