db_status

Check sync progress and database health.

Description

The db_status tool reports the current state of your HubSpot data sync. Use it to monitor initialization progress or verify your database is ready for queries.

Parameters

Parameter	Type	Required	Description
`forceReinit`	boolean	No	Set to `true` to restart sync from scratch

Status Values

Status	Meaning
`not_started`	Server hasn’t begun initialization
`sending_requests`	Export requests being sent to HubSpot
`seeding`	Quick preview loading (~1,000 deals)
`syncing`	Full export in progress
`ready`	Database synced and ready
`error`	Something went wrong

Example Response

When syncing:

{
  "status": "syncing",
  "syncProgress": "4/6 exports synced",
  "hasToken": true,
  "message": "Syncing HubSpot data... 4 of 6 exports complete."
}

When ready:

{
  "status": "ready",
  "syncProgress": "6/6 exports synced",
  "hasToken": true,
  "recordCounts": {
    "contacts": 15420,
    "companies": 3250,
    "deals": 890
  }
}

Usage

Check current status:

"What's the sync status?"

Force re-initialization:

"Re-sync my HubSpot data from scratch"