WarmHub

Get delivery feed for a subscription. Full-repository readers may receive the latest attempt response snippet in `lastResponseSnippet`; narrowed readers receive operational metadata and visible matched operations only.

warmhub_subscription_log

Get organization metadata, including its durable id, by name or by org durable id.

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

Use this when editing which pinned target versions one or more assertions' claims are affirmed for, without changing claim data. Assertions only. Mints a new version with the body copied. Do not use to change claim data (warmhub_thing_revise). An identical retry with the same submissionId returns the original receipt; a changed body under that submissionId is refused. See: docs.warmhub.ai/writes/operations

warmhub_assertion_reaffirm

Irreversibly erase one Thing's canonical content and former name while preserving its durable identity, version topology, and existing inbound references. Name the Thing by its durable ID (metadata.durableId from a read), never a wref. Needs things:redact with a whole-repository selection. Pass expectedVersion to fail if the Thing changed since you read it; without it, the current version is used. This core operation does not erase backups, completed exports, logs, or copies already delivered downstream. Supply a new eventRequestId UUID per redaction, and reuse it to retry an ambiguous outcome.

warmhub_thing_redact

Permanently delete one Thing and all its versions. This cannot be undone; to withdraw a Thing and keep its history, retract it with warmhub_thing_retract instead. Name the Thing by its durable ID (metadata.durableId from a read), never a wref. Needs things:delete with a whole-repository selection. 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

Use this when renaming one or more Things or Shapes in one ordered commit. Old spellings stop resolving, including @vN pins; the new name resolves the full history. A Shape is renamed as hub/shapes/<Old> to hub/shapes/<New>. Do not use to change content (warmhub_thing_revise). An identical retry with the same submissionId returns the original receipt; a changed body under that submissionId is refused. See: docs.warmhub.ai/writes/operations

warmhub_thing_rename

Use this when making one or more retracted Things or Shapes active again. Name each by its durable ID (metadata.durableId from a read with includeRetracted), because retracted Things can share a name; newName restores it under another name. Fails if the name is already active. Do not use on an active Thing: change one with warmhub_thing_revise, and withdraw one with warmhub_thing_retract. An identical retry with the same submissionId returns the original receipt; a changed body under that submissionId is refused. See: docs.warmhub.ai/writes/operations

warmhub_thing_restore

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

warmhub_subscription_resume

Use this when withdrawing one or more Things or assertions from HEAD while keeping their history; warmhub_thing_restore makes a retracted Thing active again. Pass expectedVersion to fail if the Thing changed since you read it. Do not use for permanent deletion (warmhub_thing_remove). An identical retry with the same submissionId returns the original receipt; a changed body under that submissionId is refused. See: docs.warmhub.ai/writes/operations

warmhub_thing_retract

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

warmhub_collection_revise

Use this when replacing the current body of one or more existing Things or assertions in one ordered commit. Each item restates the full shapes and the complete data; null data clears the body; affirmedTargets replaces an assertion's affirmation set. Mints a new version; earlier versions stay readable at @vN. Pass expectedVersion to fail if the Thing changed since you read it. Do not use to create (warmhub_thing_create) or to edit only an assertion's affirmed targets (warmhub_assertion_reaffirm). An identical retry with the same submissionId returns the original receipt; a changed body under that submissionId is refused. See: docs.warmhub.ai/writes/operations

warmhub_thing_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_thing_revise 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 things:rewrite with a whole-repository selection. 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 an operations array in the commit grammar: pass it to warmhub_commit_validate to preview, or drop each item's operation field and pass the items to the matching write tool (add → warmhub_thing_create). 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

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