get_company
ChatGPTGet information about the authenticated user's Perdoo company (tenant), including its name, country, ultimate goal, timezone, framework type, whether KPIs and strategic pillars are enabled, and the check-in frequency. Use this when the user asks about company-wide settings or needs company context before calling broader tools like list_strategic_pillars or list_timeframes.
get_kpi
ChatGPTGet a single KPI by ID, including its lead, teams, tags, and current value.
get_me
ChatGPTGet the currently authenticated Perdoo user's profile, including their ID, name, email, role, job position, active status, and manager. Use this as the first call when the user asks something about 'me', 'my objectives', or 'my KPIs' so you can resolve their user ID and pass it to follow-up tools like list_objectives, list_okrs, or list_updates.
get_objective
ChatGPTGet a single objective by ID, including its key results, lead, timeframe, and tags.
get_result
ChatGPTGet a single key result or initiative by ID, including its parent objective, lead, and tags.
get_strategic_pillar
ChatGPTGet a single strategic pillar by ID, including children, lead, timeframe, tags, and progress details.
get_team
ChatGPTGet a single team by ID, including members, sub-teams, and parent teams.
list_kpis
ChatGPTList KPIs (Key Performance Indicators) in the authenticated company, optionally filtered by name, lead user, team, or status. KPIs are ongoing health metrics, separate from timeframe-bound OKRs. Returns each KPI's ID, name, current value, starting value, metric unit, last commit status, owning teams, and lead. Use this to answer questions about operational metrics ('how is our NPS doing?', 'what KPIs does the Sales team track?'); for full detail on a single KPI, follow up with get_kpi using the returned ID.
list_objectives
ChatGPTList OKR objectives with optional filters. Returns paginated results with progress and status.
list_okrs
ChatGPTList OKRs — objectives together with their key results. This is the best tool for getting a complete picture of OKR progress.
list_results
ChatGPTList key results and initiatives (children of objectives). Key results are measurable outcomes; initiatives are action items that drive key results. Use the 'type' filter to narrow by type.
list_reviews
ChatGPTList reviews (progress updates submitted by users) with optional filters.
list_strategic_pillars
ChatGPTList strategic pillars (long-range company goals) in the authenticated company, optionally filtered by type, status, stage, lead user, or timeframe. Strategic pillars sit above OKRs in the Perdoo hierarchy — they are multi-quarter or multi-year goals that objectives and key results roll up into. Returns each pillar's ID, name, progress, status, stage, timeframe, and lead. Use this when the user asks about company strategy, long-term direction, or 'pillars'; for the full hierarchy of child objectives and roll-up progress, follow up with get_strategic_pillar using the returned ID.
list_teams
ChatGPTList teams in the authenticated company, optionally filtered by exact name, name-contains, member, parent team, or archived state. Perdoo teams form a hierarchy: every team has an optional parent team and may have sub-teams. Returns each team's ID, name, mission, lead, and archived status. Use this to discover the company's team structure, find a team by partial name (e.g. 'Engineering'), or resolve a team ID to pass into list_okrs, list_kpis, list_users, or get_team for full membership detail.
list_timeframes
ChatGPTList timeframes (planning periods) with optional filters. Use active=true to get current timeframes.
list_updates
ChatGPTList progress updates with optional filters. Shows value changes on key results, KPIs, and goals.
list_users
ChatGPTList Perdoo users in the authenticated company, optionally filtered by name, email, active status, team, role, or manager. Returns each user's ID, name, email, role (VIEW_ONLY, STANDARD, ADMIN, SUPERADMIN), job position, active status, and manager. Use this to find a specific person by name/email or to enumerate the members of a team; combine with get_team for full team detail, or pass a returned user ID as leadId / userId into other list tools to scope OKRs, KPIs, or updates to that person.
search_all
ChatGPTSearch across all Perdoo entities (objectives, key results, KPIs, users, teams, etc.) by keyword.
