Settings tools

34 MCP tools backed by the Settings endpoints.

These 34 tools call the same endpoints as the Settings section of the API Reference. Each tool runs with the permissions of the Whippy user who authorized the connection and the OAuth scopes they granted.

The Behavior column comes from the MCP tool annotations Whippy publishes. Treat these labels as hints, not guarantees: they may omit external effects (for example, a Write tool can send a message to a recipient), and clients are not required to ask for confirmation before running a tool.

Audit Logs

ToolBehaviorEndpointWhat it does
search_audit_logsRead-onlyPOST /v1/audit_logs/searchSearches the organization's audit trail. Filter by action, actor, timestamp, or associated resources, and use limit plus offset for pagination.

Integrations

ToolBehaviorEndpointWhat it does
list_integration_applicationsRead-onlyGET /v1/integrationsLists connected third-party integration applications for the organization (CRM sync apps, etc.). Prefer list_workflow_apps for workflow builder apps.

Invites

ToolBehaviorEndpointWhat it does
create_user_inviteDestructivePOST /v1/users/invitesInvites a teammate to the organization by email. Not for creating contacts.
delete_user_inviteDestructive (idempotent)DELETE /v1/users/invites/{invite_id}Cancels a pending user invite by ID.
list_user_invitesRead-onlyGET /v1/users/invitesLists pending invites for teammates to join the organization.

Member Schedules

ToolBehaviorEndpointWhat it does
create_team_member_work_scheduleWritePOST /v1/teams/{team_id}/team_members/{team_member_id}/work_schedulesCreates a work schedule for a team member.
delete_team_member_work_scheduleDestructive (idempotent)DELETE /v1/teams/{team_id}/team_members/{team_member_id}/work_schedules/{id}Deletes a team-member work schedule.
list_team_member_work_schedulesRead-onlyGET /v1/teams/{team_id}/team_members/{team_member_id}/work_schedulesLists work schedules for a specific team member.
show_team_member_work_scheduleRead-onlyGET /v1/teams/{team_id}/team_members/{team_member_id}/work_schedules/{id}Returns one team-member work schedule by ID.
update_team_member_work_scheduleDestructivePUT /v1/teams/{team_id}/team_members/{team_member_id}/work_schedules/{id}Updates a team-member work schedule.

Organization

ToolBehaviorEndpointWhat it does
show_organizationRead-onlyGET /v1/organizationReturns the current organization (from the auth context). No ID parameter — use this for org name, settings, and feature context.

Skills

ToolBehaviorEndpointWhat it does
create_agent_skillWrite (idempotent)POST /v1/agent-skillsCreates a reusable Agent skill definition that can be attached to Agents.
delete_agent_skillDestructive (idempotent)DELETE /v1/agent-skills/{id}Deletes an Agent skill definition.
list_agent_skillsRead-onlyGET /v1/agent-skillsLists reusable Whippy AI Agent skills (prompt/capability packs attachable to Agents). Not the same as Omni MCP discovery tools.
show_agent_skillRead-onlyGET /v1/agent-skills/{id}Returns one Agent skill by ID.
update_agent_skillDestructive (idempotent)PUT /v1/agent-skills/{id}Updates an Agent skill definition.

Team Members

ToolBehaviorEndpointWhat it does
create_team_memberWritePOST /v1/teams/{team_id}/team_membersAdds a user to a team. Requires team_id (from list_teams) and user_id (from search_users). user_organization_id is optional when user_id is provided.
delete_team_memberDestructive (idempotent)DELETE /v1/teams/{team_id}/team_members/{id}Removes a user from a team.
list_team_membersRead-onlyGET /v1/teams/{team_id}/team_membersLists members of a team. Requires a team ID from list_teams. Resolve user IDs with search_users.
show_team_memberRead-onlyGET /v1/teams/{team_id}/team_members/{id}Returns one team membership record by ID.
update_team_memberDestructivePUT /v1/teams/{team_id}/team_members/{id}Updates a team member's settings on that team.

Team Schedules

ToolBehaviorEndpointWhat it does
create_team_work_scheduleWritePOST /v1/teams/{team_id}/work_schedulesCreates a work schedule for a team.
delete_team_work_scheduleDestructive (idempotent)DELETE /v1/teams/{team_id}/work_schedules/{id}Deletes a team work schedule.
list_team_work_schedulesRead-onlyGET /v1/teams/{team_id}/work_schedulesLists work schedules for a team (hours of operation for assignment). Requires a team ID.
show_team_work_scheduleRead-onlyGET /v1/teams/{team_id}/work_schedules/{id}Returns one team work schedule by ID.
update_team_work_scheduleDestructivePUT /v1/teams/{team_id}/work_schedules/{id}Updates a team work schedule.

Teams

ToolBehaviorEndpointWhat it does
create_teamWritePOST /v1/teamsCreates an assignment team. Add members with create_team_member afterward.
delete_teamDestructive (idempotent)DELETE /v1/teams/{id}Deletes a team. Confirm with show_team first.
list_teamsRead-onlyGET /v1/teamsLists inbox/assignment teams (not AI Agents). Filter by name or assignment_method. Use list_team_members for roster.
show_teamRead-onlyGET /v1/teams/{id}Returns one team by ID. Resolve the ID with list_teams.
update_teamDestructivePUT /v1/teams/{id}Updates team settings (name, assignment method).

Users

ToolBehaviorEndpointWhat it does
patch_userDestructivePATCH /v1/users/USER_IDPartially updates an organization user (teammate) profile or settings.
search_usersRead-onlyPOST /v1/users/searchSearches organization users (teammates), not contacts.

Variables

ToolBehaviorEndpointWhat it does
list_organization_variablesRead-onlyGET /v1/variablesLists ready-to-paste {{…}} merge / piping tokens for messages, sequences, agents, campaigns, and forms.

Did this page help you?