zapier-status

What this skill does

# Zapier status

Three modes for monitoring and maintaining a Zapier MCP setup. Determine the mode from context, or ask if unclear.

**First, detect the server mode:** If `list_enabled_zapier_actions` is available, the user is on **Agentic mode**. Otherwise, the user is on **Classic mode** where each configured action is its own MCP tool (e.g., `slack_send_channel_message`, `gmail_find_email`).

## Mode 1: Health check

**Trigger:** "check my tools", "zapier status", "is everything working?", or any general status inquiry.

A quick dashboard view of the current state.

### Steps

1. Check the available tools:
   - **Agentic mode:** Call `list_enabled_zapier_actions` to get the inventory of enabled actions.
   - **Classic mode:** Inspect the available Zapier MCP tools. Each action tool follows the pattern `app_action_name`. The built-in `get_configuration_url` tool is always present when the server is connected.

2. If no Zapier tools are available: report the connection status and suggest running **zapier-setup** (Classic) or calling `get_zapier_skill` with name `"zapier-mcp-onboarding"` (Agentic).

3. If tools/actions are available, build a summary by grouping actions by app (Agentic: from the `list_enabled_zapier_actions` response; Classic: from each tool's description):

**For each app**, show:

- App name
- Number of actions
- Action types (infer read vs write from names: find/search/get/list = read, send/create/update/add = write)
- Quick status: working / needs auth / error

**Format as a dashboard:**

```
Zapier MCP status
=================
Server: connected
Total actions: 14 across 5 apps

Slack         3 actions (2 read, 1 write)     ✓ working
Gmail         3 actions (1 read, 2 write)     ✓ working
Google Cal    2 actions (1 read, 1 write)     ✓ working
Jira          3 actions (2 read, 1 write)     ✓ working
Google Docs   2 actions (1 read, 1 write)     ✓ working
```

4. If any actions appear broken (based on recent errors or auth issues), flag them.

5. End with: "Everything looks good." or "Found [N] issues. Want me to diagnose them?"

## Mode 2: Audit

**Trigger:** "audit my setup", "clean up my tools", "find duplicates", "what should I remove?"

Find inefficiencies: duplicate actions, unused tools, conflicts with native MCP servers.

### Steps

1. Get the full inventory:
   - **Agentic mode:** Call `list_enabled_zapier_actions`.
   - **Classic mode:** Inspect the available Zapier MCP action tools.

2. **Check for duplicates within Zapier MCP:**
   - Multiple actions for the same app that do similar things (e.g., both `slack_find_message` and `slack_search_messages`)
   - Recommend removing the less useful one

3. **Check for conflicts with native MCP servers:**
   - Look at other MCP servers configured in the client's MCP config file (e.g., `.cursor/mcp.json`, `claude_desktop_config.json`, `.mcp.json` — depends on the client)
   - If the user has both a native Slack MCP and Zapier Slack actions, flag it
   - Recommend: "You have Slack through both Zapier and a native Slack server. The native server is usually better for single-app use. Consider removing Zapier's Slack actions."

4. **Check for unused or low-value actions:**
   - Actions that are rarely useful as defaults (e.g., very specific write actions that are only needed occasionally)
   - Suggest removing actions that can be re-added on demand through the web UI

5. **Show the audit report:**

```
Audit results
=============
Duplicates:       1 found
  - Slack: "find_message" and "search_messages" overlap. Recommend removing "search_messages".

Native conflicts:  1 found
  - Slack: native Slack MCP also configured. Consider removing Zapier Slack actions.

Cleanup candidates: 2 found
  - Google Sheets "delete_row": rarely needed, can re-add on demand
  - Jira "add_attachment": niche action, add when needed

Recommended removals: 4 actions
Want me to show you how to clean these up?
```

6. If the user says yes:
   - **Agentic mode:** Use `disable_zapier_action` to remove the recommended actions directly in chat.
   - **Classic mode:** Call `get_configuration_url` and direct them to the web UI to remove the recommended actions. List exactly which ones to remove.

## Mode 3: Diagnose

**Trigger:** "what's broken?", "my tools aren't working", "debug my MCP", or when a specific tool call has failed.

Systematic troubleshooting with error pattern matching.

### Steps

1. **Gather context:** Ask what went wrong, or use the error from the current conversation.

2. **Run diagnostics in order:**

   a. **Connection check:** Try calling `get_configuration_url` or any available Zapier tool. If nothing works, the problem is server-level (auth, config, network).

   b. **Action check:**
      - **Agentic mode:** Call `list_enabled_zapier_actions` to see if the action is enabled. If not, use `discover_zapier_actions` to find it and `enable_zapier_action` to add it.
      - **Classic mode:** Is the specific action tool available? If not, the user needs to add it through the web UI.

   c. **Auth check:** Try calling a read action for the affected app (Agentic: `execute_zapier_read_action`; Classic: the specific read tool). If it returns an auth error, the app connection needs re-authentication.

   d. **Parameter check:** Review the failing call's parameters. Common issues:
   - Missing required fields
   - Wrong field format (IDs vs names)
   - Instructions that are too vague for the params resolver

3. **Match against known error patterns:**

| Symptom                                    | Likely cause                        | Fix                                                           |
| ------------------------------------------ | ----------------------------------- | ------------------------------------------------------------- |
| All tools fail                             | Server auth expired                 | Re-authenticate at mcp.zapier.com                             |
| One app fails, others work                 | App-level auth expired              | Re-connect that specific app                                  |
| Tool not found / unavailable               | Action not configured               | Agentic: `discover_zapier_actions` + `enable_zapier_action`. Classic: direct user to `get_configuration_url` to add it |
| "invalid params"                           | Wrong fields or format              | Check the tool's parameter schema                             |
| Results are empty but expected data exists | Search too narrow or wrong field    | Broaden the search or check field names                       |
| Timeout on execute                         | Server overloaded or action is slow | Retry once, then report if persistent                         |
| "rate limit exceeded"                      | Too many calls                      | Space out requests, wait 30 seconds                           |
| Works in one project, fails in another     | Project-level vs global config      | Check both project-level and global MCP config for the client |

4. **Report findings:**

"Here's what I found:

- **Connection**: OK (server responding)
- **Actions**: 14 tools available across 5 apps
- **Auth issue**: Gmail connection expired. You need to re-authenticate Gmail at mcp.zapier.com.
- **Recommendation**: [direct link or specific instruction]"

5. If the fix requires user action (re-auth, config change), provide the specific link or instruction. If it's something the AI can fix (adjust parameters, try a different tool), offer to do it.

## General notes

- Always check available Zapier MCP tools as the first diagnostic step in any mode. On Agentic, this means calling `list_enabled_zapier_actions`. On Classic, this means inspecting the available tool names.
- Don't dump raw error messages. Translate them into plain language.
- If a problem is beyond what the skill can diagnose (server-side bug, API outage), say so and suggest checking [status.zapier.com](https://status.zapier.com) or cont