FirecrawlSearchApi
ChatGPTPerform an advanced search using Firecrawl v2 Submits a rich query to Firecrawl and retrieves structured results including URLs, titles, and descriptions. POST https://api.firecrawl.dev/v2/search.
ResearchCompanyWebsite
ChatGPTResearch this company website. Read the public website for this company and return page titles, URLs, and snippets. Does not change user or CRM data.
addPipelineEntriesToRoom
ChatGPTAttach one or more existing pipeline entries (leads) to a lead room Joel Pilger API POST /api/v1/lead-rooms/{id}/pipeline-entries.
authMe
ChatGPTSession details (Clerk id + local user when resolved) Joel Pilger API GET /api/v1/auth/me.
createCenterfile
ChatGPTCreate a new Centerfile (Centerfile Copilot sync) Called by the Centerfile Copilot GPT after the user confirms a draft. content is a free-form JSON object whose keys are v3.0 section names. Sales Scout stores it opaquely. Joel Pilger API POST /api/v1/me/centerfiles.
createLead
ChatGPTCreate a new lead (pipeline entry) Structured write. Scout MUST confirm the payload with the user before calling. Resolve ownedByUserId via GET /pipeline/assignable-users. Enum values are case-sensitive. Joel Pilger API POST /api/v1/pipeline.
createLeadRoom
ChatGPTCreate a lead room (with initial pipeline entries and optional linked chats) Joel Pilger API POST /api/v1/lead-rooms.
createLeadRoomTask
ChatGPTAdd a checklist task to a lead room Joel Pilger API POST /api/v1/lead-rooms/{id}/tasks.
createLinkedChat
ChatGPTLog a GPT chat (ChatGPT URL) against a lead room Joel Pilger API POST /api/v1/lead-rooms/{id}/linked-chats.
crm_connection_status
ChatGPTCheck the user's CRM connection status (call before other crm_ tools) Returns the active CRM connection (or null when the user has not connected a CRM). If null or status is not CONNECTED, tell the user to connect their CRM in Sales Scout → Settings → CRM Integrations, and do not call other crm_ tools. Joel Pilger API GET /api/v1/crm/connection.
crm_create_note
ChatGPTCreate a note in the CRM (preview + confirm first) Joel Pilger API POST /api/v1/crm/notes.
crm_create_record
ChatGPTCreate a CRM record with full fields (preview + confirm first) Never name-only when more context exists. Resolve companyId, primaryContactId, pipelineId, stageId, ownerId first. Pass full CrmWriteFields. Optional note+task on the same create. Preview exact JSON, one yes, then call. Joel Pilger API POST /api/v1/crm/records.
crm_create_records
ChatGPTCreate up to 10 CRM records in one call (one preview, one confirm) Bulk create (max 10). Preview items[] once, one yes, then call once. Resolve/create companies first so people include companyId. Partial success — do not retry ok indexes. Joel Pilger API POST /api/v1/crm/records/batch.
crm_create_task
ChatGPTCreate a task in the CRM (preview + confirm first) Joel Pilger API POST /api/v1/crm/tasks.
crm_get_activities
ChatGPTList activities on a CRM record Joel Pilger API GET /api/v1/crm/records/{entityType}/{id}/activities.
crm_get_notes
ChatGPTList notes on a CRM record Joel Pilger API GET /api/v1/crm/records/{entityType}/{id}/notes.
crm_get_record
ChatGPTRetrieve a single CRM record (company, person, lead, opportunity) Joel Pilger API GET /api/v1/crm/records/{entityType}/{id}.
crm_get_tasks
ChatGPTList tasks on a CRM record Joel Pilger API GET /api/v1/crm/records/{entityType}/{id}/tasks.
crm_list_pipelines
ChatGPTList CRM pipelines and their stages Joel Pilger API GET /api/v1/crm/pipelines.
crm_list_stages
ChatGPTList CRM pipeline stages (optionally filtered by pipelineId) Joel Pilger API GET /api/v1/crm/stages.
crm_list_users
ChatGPTList CRM users (resolve ownerId for creates/updates) Returns CRM users so you can set fields.ownerId by name/email. Always resolve owner before creating an opportunity or assigning a person. Joel Pilger API GET /api/v1/crm/users.
crm_search_companies
ChatGPTSearch CRM companies Joel Pilger API GET /api/v1/crm/companies.
crm_search_leads
ChatGPTSearch CRM leads (may be unsupported by some providers → 400) Joel Pilger API GET /api/v1/crm/leads.
crm_search_opportunities
ChatGPTSearch CRM opportunities (deals) Joel Pilger API GET /api/v1/crm/opportunities.
crm_search_people
ChatGPTSearch CRM people (contacts) Joel Pilger API GET /api/v1/crm/people.
crm_update_record
ChatGPTUpdate allowed fields on a CRM record (additive; preview + confirm first) Canonical CrmWriteFields only. Opportunity: stageId, pipelineId, monetaryValue, status, closeDate, ownerId. Person: title, email, phone, companyId, linkedinUrl, details. Preview exact fields; one yes/no before calling. Joel Pilger API PATCH /api/v1/crm/records/{entityType}/{id}.
getCenterfile
ChatGPTGet full Centerfile (identity payload for Scout) Joel Pilger API GET /api/v1/me/centerfiles/{id}.
getLeadRoom
ChatGPTGet full lead room detail Joel Pilger API GET /api/v1/lead-rooms/{id}.
getPipelineEntry
ChatGPTGet one pipeline entry (lead) Joel Pilger API GET /api/v1/pipeline/{id}.
listAssignableOwners
ChatGPTList users who can own a pipeline entry (for resolving ownedByUserId) Always call this before POST /pipeline or before PATCHing ownedByUserId. Match on name/email and echo the chosen user to the human — never invent a userId. Joel Pilger API GET /api/v1/pipeline/assignable-users.
listCenterfiles
ChatGPTList Centerfiles for the user Joel Pilger API GET /api/v1/me/centerfiles.
listLeadRooms
ChatGPTList lead rooms for the user Joel Pilger API GET /api/v1/lead-rooms.
listMyGpts
ChatGPTList GPTs assigned to the user (metadata, URLs) Joel Pilger API GET /api/v1/me/gpts.
listPipeline
ChatGPTList pipeline entries (leads) for the authenticated user Joel Pilger API GET /api/v1/pipeline.
patchCenterfile
ChatGPTUpdate a Centerfile (rename and/or replace content) Called by the Centerfile Copilot GPT to push refinements. content is replace-all — read the current Centerfile first, merge edits client-side, then PATCH the full object. name is renamable on its own. Joel Pilger API PATCH /api/v1/me/centerfiles/{id}.
patchLeadRoom
ChatGPTRename / re-describe a lead room Joel Pilger API PATCH /api/v1/lead-rooms/{id}.
patchLeadRoomNotes
ChatGPTReplace lead-room notes (append client-side first if you want to keep history) Joel Pilger API PATCH /api/v1/lead-rooms/{id}/notes.
patchLeadRoomTask
ChatGPTUpdate a task (rename, complete/uncomplete, reorder) Joel Pilger API PATCH /api/v1/lead-rooms/{id}/tasks/{taskId}.
patchLinkedChat
ChatGPTUpdate a logged GPT chat entry Joel Pilger API PATCH /api/v1/lead-rooms/{id}/linked-chats/{chatId}.
patchPipelineEntry
ChatGPTUpdate a lead (structured write — exact enums) Joel Pilger API PATCH /api/v1/pipeline/{id}.
setDefaultCenterfile
ChatGPTMark a Centerfile as the user's default Joel Pilger API PATCH /api/v1/me/centerfiles/{id}/set-default.
whoAmI
ChatGPTVerify access — invoke on session start and sign-in requests Call first each session and when user asks to sign in or check access. HTTP 401 renders ChatGPT's Sign In button; prose without this call does not. Returns 200 only for ACTIVE provisioned users. Joel Pilger API GET /api/v1/integrations/whoami.