Skip to content

MCP Tools Reference

The Nucleus MCP server exposes 120+ tools covering the full platform. See the MCP Setup guide for connection instructions.

All tools respect your Nucleus access level — data is automatically scoped to what you’re permitted to see and do.


The most powerful capability — ask anything in plain English.

ToolDescription
query_nucleusAsk a natural language question. Converted to SQL by Kimi K2.5 and executed read-only against the database. Results capped at 200 rows, scoped to your access level. Examples: “which clients have no active projects?”, “who logged the most time last month?”, “show deals stuck in negotiation > 30 days”

ToolDescription
get_meYour profile, access level, and permissions
get_dashboardDashboard stats, focus items, and overdue tasks
get_notificationsRecent notifications (filter: all / unread)
get_unread_countNotification badge count
mark_notification_readMark a single notification as read
mark_all_notifications_readMark all notifications as read
get_notification_preferencesYour notification preferences
update_notification_preferencesUpdate which notifications you receive

ToolDescription
searchFull-text search across all entities — returns tasks, projects, clients, people, deals, pages, notes, and more

ToolDescription
list_action_itemsAction items with filters (module, urgency, resource, assignee, completion)
get_action_centreCombined action centre page — items, counts, and sprint context in one call
create_action_itemCreate a manual action item
update_action_itemUpdate an action item
complete_action_itemMark an action item as done

ToolDescription
list_tasksTasks with filters (assignee, status, priority, type, due date, resource)
get_taskFull task detail — subtasks, todos, comments, attachments, history
create_taskCreate a task
update_taskUpdate title, description, assignee, priority, status, due date
add_task_commentAdd a comment

ToolDescription
list_sprintsSprints with filters (project, status)
get_sprintSprint detail with tasks and backlog
create_sprintCreate a sprint
update_sprintUpdate sprint name, dates, or status
assign_task_to_sprintAdd a task to a sprint
remove_task_from_sprintRemove a task from a sprint

ToolDescription
list_roadmapsRoadmaps list
get_roadmapRoadmap detail with items and linked tasks
create_roadmapCreate a roadmap
update_roadmapUpdate a roadmap
create_roadmap_itemAdd an item to a roadmap
update_roadmap_itemUpdate a roadmap item

ToolDescription
list_projectsProjects with filters (status, client, owner, type)
get_projectProject detail — team, budget, linked resources
list_project_reportsProject reports
get_latest_project_reportMost recent report for a project
get_project_reportSingle report detail
generate_project_reportTrigger AI report generation
update_project_reportEdit a report
send_project_reportSend report to client
get_report_settingsProject report settings
update_report_settingsUpdate report settings
list_reports_dueReports due for sending

ToolDescription
get_resourcing_scheduleFull resourcing timeline
get_resourcing_capacityTeam capacity overview
get_resourcing_forecastFuture availability forecast
create_allocationCreate a resource allocation
update_allocationUpdate an allocation
get_user_scheduleSchedule for a specific person
list_resourcing_suggestionsAI-generated resourcing suggestions
apply_resourcing_suggestionApply a suggestion
dismiss_resourcing_suggestionDismiss a suggestion

ToolDescription
list_time_entriesTime entries (filter by date range, person, project, client)
create_time_entryLog time against a project or resource

ToolDescription
list_tracking_draftsAuto-detected time tracking drafts awaiting review
get_tracking_draftDraft detail including activity signals
accept_tracking_draftAccept a draft and create a time entry
dismiss_tracking_draftDismiss a draft
get_auto_tracking_preferencesAuto-tracking settings
update_auto_tracking_preferencesUpdate settings

ToolDescription
list_calendar_eventsCalendar events
create_calendar_eventCreate a calendar event
list_eventsCompany events (offsites, team events, etc.)
create_eventCreate a company event
update_eventUpdate a company event

ToolDescription
list_meetingsMeetings with filters (category, entity, attendee, date range)
get_meetingMeeting detail — participants, summary, action items
get_meeting_transcriptTranscript (fetched from Granola)
create_task_from_meetingCreate a task from a meeting action item
update_meeting_action_itemUpdate action item status

ToolDescription
list_peopleTeam directory (scoped to your access level)
get_personFull person profile — contact details, links, history

ToolDescription
list_squadsAll squads
get_squadSquad detail — members, manager
update_squadUpdate squad name or manager
get_squad_performanceSquad performance metrics
list_squad_sessionsSquad sessions (standups, retros)
get_squad_sessionSession detail
create_squad_sessionCreate a session
update_squad_sessionUpdate a session
complete_squad_sessionMark session as complete
generate_squad_session_briefAI-generated session brief
list_squad_tasksTasks for the squad
create_squad_taskCreate a task for the squad

ToolDescription
get_onboarding_phasesOnboarding checklist phases and items
get_onboarding_progressProgress for scoped users
toggle_onboarding_itemMark an item complete or incomplete

ToolDescription
list_review_cyclesReview cycles
get_review_cycleCycle detail
create_review_cycleCreate a review cycle
update_review_cycleUpdate a review cycle
list_reviewsReviews (filter by cycle, person)
get_reviewReview detail
create_reviewCreate a review
update_reviewUpdate a review
get_my_goalsYour current goals
get_my_self_assessmentsYour self-assessments
get_review_historyHistorical review data
get_360_feedback_requests360 feedback requests
create_360_feedback_requestRequest 360 feedback
submit_360_feedbackSubmit a 360 feedback response
get_360_feedback_summarySummary of received feedback
get_performance_alertsPerformance alerts for your team

ToolDescription
list_scorecardsScorecards (scoped to your access level)
get_scorecardScorecard detail — scores, KPIs

ToolDescription
list_objectivesCompany / team objectives
get_objectiveObjective detail with priorities and KPIs
get_my_kpisYour KPIs
create_objectiveCreate an objective
update_objectiveUpdate an objective
create_priorityAdd a priority to an objective
update_priorityUpdate a priority
create_kpiAdd a KPI to a priority
update_kpiUpdate a KPI

ToolDescription
list_leave_requestsLeave requests (scoped)
create_leave_requestSubmit a leave request
get_leave_balanceLeave balance by type

ToolDescription
get_pay_summaryPay summary
list_payslipsPayslips
get_payslipPayslip detail
refresh_payroll_dataTrigger payroll sync

ToolDescription
get_people_insightsHeadcount, retention, diversity, compensation overview
get_headcount_trendMonthly headcount trend
get_retention_insightsTenure distribution and turnover
get_diversity_insightsGender breakdown and age distribution

ToolDescription
list_holidaysPublic holidays (filter by year, state)
get_holiday_stateResolve the effective state for the current user

ToolDescription
list_jobsOpen job listings
list_candidatesCandidates with filters
get_candidateCandidate detail — applications, interviews, assessments

ToolDescription
list_clientsClients with tier and health scores
get_clientClient detail
get_client_onboardingClient onboarding progress
get_client_resultsAggregated performance results and trends

ToolDescription
list_dealsDeal pipeline
get_dealDeal detail
create_dealCreate a deal
update_deal_stageMove a deal to a new pipeline stage

ToolDescription
get_relationship_profileRelationship health profile for a contact
update_relationship_profileUpdate relationship notes
list_life_eventsLife events for a contact
create_life_eventLog a life event
list_relationship_actionsRelationship touchpoint actions
list_contact_actionsActions for a specific contact
create_relationship_actionLog a touchpoint
update_relationship_action_statusUpdate action status
get_client_relationship_summaryRelationship summary for a client
list_company_partnersCompany partner relationships
create_company_partnerAdd a partner relationship

ToolDescription
get_heatmapService × client heatmap grid
get_heatmap_statsSummary stats and opportunity value
get_heatmap_cellSingle cell detail with history

ToolDescription
run_researchRun AI research on a company or contact
get_research_briefGet a research brief
list_deal_research_briefsResearch briefs for a deal
list_company_research_briefsResearch briefs for a company
refresh_research_briefRefresh a stale brief

ToolDescription
list_invoicesInvoices with filters (client, status, date range)
get_invoiceInvoice detail

ToolDescription
list_budgetsBudgets
get_budgetBudget detail with utilisation

ToolDescription
list_contractsContracts
get_contractContract detail

ToolDescription
list_proposalsProposals
get_proposalProposal detail

ToolDescription
get_profitabilityProfitability summary — per-project and per-client breakdown
get_profitability_trend12-month monthly trend

ToolDescription
get_reporting_summaryFinancial and utilisation summary
get_reporting_breakdownBreakdown by squad or team member
get_reporting_trends12-month revenue, profit, and hours trend

ToolDescription
list_sla_policiesSLA policies
create_sla_policyCreate a policy
update_sla_policyUpdate a policy
get_task_slaSLA status for a task
assign_slaAssign SLA to a task
record_sla_responseRecord first response time
record_sla_resolutionRecord resolution time
get_sla_complianceSLA compliance dashboard

ToolDescription
list_pagesWiki pages
get_pagePage content
create_pageCreate a page
update_pageUpdate a page
list_page_versionsVersion history for a page
get_page_versionA specific page version
list_page_discussionsDiscussions on a page
create_page_discussionStart a discussion

ToolDescription
list_announcementsAnnouncements
create_announcementCreate an announcement

ToolDescription
list_notesNotes for any resource (filter by entity type + ID)
create_noteCreate a note linked to any entity

ToolDescription
list_email_threadsEmail threads
get_email_threadThread detail with messages
list_emails_by_companyEmails for a company
list_emails_by_contactEmails for a contact
send_emailSend an email

ToolDescription
list_documentsDocuments for a person

ToolDescription
get_custom_fieldsCustom field definitions by entity type
get_custom_field_valuesCustom field values for an entity
set_custom_field_valuesSet custom field values for an entity

ToolDescription
get_analyticsUtilisation, deal pipeline, or profitability analytics (pass type param)

Seven read-only resources provide lookup data for valid IDs used in tool parameters. Access via your client’s resource picker.

Resource URIDescription
nucleus://config/task-statusesTask status IDs and labels
nucleus://config/task-prioritiesPriority IDs and labels
nucleus://config/task-typesTask type IDs and labels
nucleus://config/deal-stagesDeal pipeline stage IDs
nucleus://config/leave-typesLeave type IDs and names
nucleus://config/squadsSquad IDs and names
nucleus://config/service-typesService types and billable rates