Tool Reference

list_workflows

List all available workflows with costs and availability.

List all available workflows with their agent counts, credit costs, estimated durations, and whether each is available on the current plan. Call this first to discover which workflows you can run.

Parameters

This tool takes no user-supplied parameters.

Parameter Type Required Description
companyId string Auto-injected Injected from your API key. Do not pass this.

Example Request

curl -X POST https://socialcrm.com/api/mcp-app \
  -H "Authorization: Bearer sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/call",
    "params": {
      "name": "list_workflows",
      "arguments": {}
    }
  }'

Example Response

Parsed from result.content[0].text:

{
  "plan": "pro",
  "maxConcurrentRuns": 3,
  "monthlyCredits": 500,
  "workflows": [
    {
      "id": "ai_shop_checkup",
      "name": "AI Shop Checkup",
      "tagline": "See exactly what AI tells customers about your shop — and whether it's right.",
      "description": "Run a comprehensive audit of your shop's AI presence across ChatGPT, Claude, Gemini, and Perplexity...",
      "trigger": "Monthly health check, board reporting, after a website redesign, or before a big promotion.",
      "agentCount": 5,
      "estimatedDuration": "3-5 min",
      "creditCost": 25,
      "availableOnPlan": true
    },
    {
      "id": "fix_visibility",
      "name": "Fix My Visibility",
      "tagline": "AI says you close at 5pm. You're open till 9. Fix it.",
      "description": "You found inaccuracies — wrong hours, missing services...",
      "trigger": "After an AI Shop Checkup found issues...",
      "agentCount": 4,
      "estimatedDuration": "4-6 min",
      "creditCost": 20,
      "availableOnPlan": true
    }
  ]
}

Output Schema

Field Type Description
plan string Current plan key (e.g., "free", "pro", "enterprise")
maxConcurrentRuns number Maximum simultaneous workflow runs allowed
monthlyCredits number Monthly credit allocation for the plan
workflows array List of all workflow definitions
workflows[].id string Workflow ID (pass to run_workflow)
workflows[].name string Human-readable workflow name
workflows[].tagline string Short one-liner description
workflows[].description string Full description of what the workflow does
workflows[].trigger string When to use this workflow
workflows[].agentCount number Number of AI agents in the workflow
workflows[].estimatedDuration string Expected run time
workflows[].creditCost number Credits consumed per run
workflows[].availableOnPlan boolean Whether your current plan includes this workflow

Notes

  • This tool returns all six workflows regardless of plan. Check availableOnPlan to see which ones you can actually run.
  • Available workflow IDs: ai_shop_checkup, fix_visibility, competitive_scan, content_refresh, full_service, reputation_shield.