Hobbes

Returns queued/running/succeeded/failed status for one agent publish job, with a safe failure message and final production link after success.

get_agent_publish_job

Returns one Custom Link with its personalization, sharing metadata, campaign, active state, and thumbnail status.

get_custom_link

Returns status, progress, counters, and timestamps for an asynchronous Custom Link job (creation, thumbnail regeneration, or retry). Call this after create_custom_links to track completion; set include_items: true for per-link outcomes, logoStatus, prospectLogoUrl, and shareThumbnailUrl. Wait for a terminal job before using shareThumbnailUrl as an email image; inspect warnings for missing logos. Omit job_id to list recent jobs, newest first.

get_custom_link_job

Returns aggregate funnel performance for a trailing UTC window of days. totalSessions and bookedCount count sessions; qualifiedCount and highIntentCount count unique active people. qualificationRate is the percentage of unique active people who are currently qualified, not qualified sessions divided by totalSessions. avgDurationSeconds is the mean session duration. Use for overall performance questions rather than per-session or per-person detail.

get_funnel_metrics

Returns one prospect's aggregated profile by exact email address.

get_person

Returns the full sales analysis for one session: qualification status, buying intent, summary, next steps, conversation timeline, topics discussed, objections raised, booking status, and acquisition/device/location attribution. Prefer this over the transcript — it answers most questions about what happened in a session.

get_session

Returns the ordered conversation turns for one session. Transcripts are sensitive raw conversation data and reads count against a daily organization quota — retrieve one only when the analysis from get_session is insufficient to answer the question.

get_session_transcript

Lists ready Hobbes-generated suggestion groups whose changes all target Playbook sections, including stored evidence and exact proposed payloads. Suggestions exist for the default Role only; another role_id returns an empty list with unavailableReason set.

list_playbook_suggestions

Returns the organization's agent Roles (default Role first) with their ids, names, active state and objective. Every Playbook tool accepts an optional role_id from this list; a call without one acts on the default Role and its response says so.

list_roles

Returns B2B engagement rollups grouped by registrable email domain — a company-level view aggregating all people and sessions from that domain. Use for account- or company-level questions.

list_accounts

Returns funnel events with the attribution evidence each one captured: UTM values, which click-ID types were present (never their values), page domain and path, referrer host, and whether it is an explicit paid touch. A copied first-touch snapshot is labelled and never counted as a paid touch. Stored session attribution (needs sessions:read), People first source (needs sessions:read and people:read), and custom-link references (needs custom_links:read) are separate blocks, marked omitted_missing_scope when not granted. Page with next_cursor; every page reads the snapshot fixed by the first page.

list_attribution_touches

Returns the changes derived for one Role (role_id), newest first, optionally filtered by status (pending, routed, dismissed, superseded), together with where the Role's draft is now (draft.revision_id, sections_etag, draft_etag). A change marked stale was derived against an earlier draft and answers conflict if applied; re-derive its feedback. Carry the draft tokens from this response into apply_coaching_changes. Organization admins only.

list_coaching_changes

Returns the coaching feedback filed against one Role (role_id from list_roles), newest first, with the Role's backlog summary (feedback_total, feedback_underived, changes_pending). Each row says whether changes were derived from it (derivation, 0 when never), how many wait for review (pending_changes) and how many a reviewer applied (routed_changes). To page, send the last row's created_at and id as before_created_at and before_id. Organization admins only.

list_coaching_feedback

Returns Custom Link campaigns and their link counts. Pass campaign_id to fetch a single campaign.

list_custom_link_campaigns

Returns the organization's personalized demo links (Custom Links), filterable by active state, campaign, and search, including each link's current thumbnail state.

list_custom_links

Returns prospect profiles aggregated across all of each person's sessions: engagement history, first/last seen, total sessions, qualification status, and buying intent. Most recently seen first. Use this for questions about people rather than individual sessions.

list_people

Returns analyzed production demo sessions for the connected organization, newest first. Use the filters to narrow by outcome (qualification, buying intent, booked status) or time window before pulling individual session details.

list_sessions

Validates exact restricted JSON Patch operations against a cloned staging Playbook of one Role (role_id; the default Role when omitted) and returns a deterministic before/after summary. This never changes staging.

preview_playbook_update

Starts an asynchronous production publish of one Role's exact current staging version (role_id; the default Role when omitted). Requires native user confirmation and runs the existing conversation-test gate. The publish fails if the Role's draft changes after the job is queued.

publish_agent_version