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
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
search_audit_logs | Read-only | POST /v1/audit_logs/search | Searches the organization's audit trail. Filter by action, actor, timestamp, or associated resources, and use limit plus offset for pagination. |
Integrations
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
list_integration_applications | Read-only | GET /v1/integrations | Lists connected third-party integration applications for the organization (CRM sync apps, etc.). Prefer list_workflow_apps for workflow builder apps. |
Invites
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
create_user_invite | Destructive | POST /v1/users/invites | Invites a teammate to the organization by email. Not for creating contacts. |
delete_user_invite | Destructive (idempotent) | DELETE /v1/users/invites/{invite_id} | Cancels a pending user invite by ID. |
list_user_invites | Read-only | GET /v1/users/invites | Lists pending invites for teammates to join the organization. |
Member Schedules
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
create_team_member_work_schedule | Write | POST /v1/teams/{team_id}/team_members/{team_member_id}/work_schedules | Creates a work schedule for a team member. |
delete_team_member_work_schedule | Destructive (idempotent) | DELETE /v1/teams/{team_id}/team_members/{team_member_id}/work_schedules/{id} | Deletes a team-member work schedule. |
list_team_member_work_schedules | Read-only | GET /v1/teams/{team_id}/team_members/{team_member_id}/work_schedules | Lists work schedules for a specific team member. |
show_team_member_work_schedule | Read-only | GET /v1/teams/{team_id}/team_members/{team_member_id}/work_schedules/{id} | Returns one team-member work schedule by ID. |
update_team_member_work_schedule | Destructive | PUT /v1/teams/{team_id}/team_members/{team_member_id}/work_schedules/{id} | Updates a team-member work schedule. |
Organization
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
show_organization | Read-only | GET /v1/organization | Returns the current organization (from the auth context). No ID parameter — use this for org name, settings, and feature context. |
Skills
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
create_agent_skill | Write (idempotent) | POST /v1/agent-skills | Creates a reusable Agent skill definition that can be attached to Agents. |
delete_agent_skill | Destructive (idempotent) | DELETE /v1/agent-skills/{id} | Deletes an Agent skill definition. |
list_agent_skills | Read-only | GET /v1/agent-skills | Lists reusable Whippy AI Agent skills (prompt/capability packs attachable to Agents). Not the same as Omni MCP discovery tools. |
show_agent_skill | Read-only | GET /v1/agent-skills/{id} | Returns one Agent skill by ID. |
update_agent_skill | Destructive (idempotent) | PUT /v1/agent-skills/{id} | Updates an Agent skill definition. |
Team Members
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
create_team_member | Write | POST /v1/teams/{team_id}/team_members | Adds 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_member | Destructive (idempotent) | DELETE /v1/teams/{team_id}/team_members/{id} | Removes a user from a team. |
list_team_members | Read-only | GET /v1/teams/{team_id}/team_members | Lists members of a team. Requires a team ID from list_teams. Resolve user IDs with search_users. |
show_team_member | Read-only | GET /v1/teams/{team_id}/team_members/{id} | Returns one team membership record by ID. |
update_team_member | Destructive | PUT /v1/teams/{team_id}/team_members/{id} | Updates a team member's settings on that team. |
Team Schedules
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
create_team_work_schedule | Write | POST /v1/teams/{team_id}/work_schedules | Creates a work schedule for a team. |
delete_team_work_schedule | Destructive (idempotent) | DELETE /v1/teams/{team_id}/work_schedules/{id} | Deletes a team work schedule. |
list_team_work_schedules | Read-only | GET /v1/teams/{team_id}/work_schedules | Lists work schedules for a team (hours of operation for assignment). Requires a team ID. |
show_team_work_schedule | Read-only | GET /v1/teams/{team_id}/work_schedules/{id} | Returns one team work schedule by ID. |
update_team_work_schedule | Destructive | PUT /v1/teams/{team_id}/work_schedules/{id} | Updates a team work schedule. |
Teams
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
create_team | Write | POST /v1/teams | Creates an assignment team. Add members with create_team_member afterward. |
delete_team | Destructive (idempotent) | DELETE /v1/teams/{id} | Deletes a team. Confirm with show_team first. |
list_teams | Read-only | GET /v1/teams | Lists inbox/assignment teams (not AI Agents). Filter by name or assignment_method. Use list_team_members for roster. |
show_team | Read-only | GET /v1/teams/{id} | Returns one team by ID. Resolve the ID with list_teams. |
update_team | Destructive | PUT /v1/teams/{id} | Updates team settings (name, assignment method). |
Users
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
patch_user | Destructive | PATCH /v1/users/USER_ID | Partially updates an organization user (teammate) profile or settings. |
search_users | Read-only | POST /v1/users/search | Searches organization users (teammates), not contacts. |
Variables
| Tool | Behavior | Endpoint | What it does |
|---|---|---|---|
list_organization_variables | Read-only | GET /v1/variables | Lists ready-to-paste {{…}} merge / piping tokens for messages, sequences, agents, campaigns, and forms. |
Updated about 3 hours ago
Did this page help you?
