Skip to content
MCP tools
Read-onlyGoalsMCP tool

goals_list

Search the caller's goals (KPI targets like "12 closings this quarter" or "get my first subscriber").

Last updated

Search the caller's goals (KPI targets like "12 closings this quarter" or "get my first subscriber"). Returns pagination info (total_count, has_more, offset, limit). Each result includes: id, name, metric, target_value, period_type, period_start, period_end, status, accent, created_at, plus plan progress (plan_done, plan_total, plan_pct) counted from the goal's milestones.

Note

for the five derived metrics (closings, gci, lead_conversions, appointments, listings_taken) the CURRENT metric value is calculated live by the web app from escrows/leads/appointments/listings and is deliberately NOT returned here — plan progress is. current_value is returned only for metric="manual", where the owner sets the number. Filter by status, metric, or period_type. For one goal plus its milestones, use goals_get.

Parameters#

ParameterTypeRequiredDescription
querystringNoSearch term — matches against goal name and description (case-insensitive partial match)
statusenumNoFilter by status (default: all) · One of: all, active, paused, achieved, missed
metricenumNoFilter by the metric the goal targets · One of: closings, gci, lead_conversions, appointments, listings_taken, manual
period_typeenumNoFilter by period length · One of: weekly, monthly, quarterly, annually, custom
limitnumberNoMaximum results (default: 50, max: 500) · Max: 500 · Min: 1
offsetnumberNoSkip N results for pagination (default: 0) · Min: 0

Example prompts#

  • "What goals am I working on this quarter?"
  • "Show me my paused goals."

Safety#

Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.