plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "warminboxes",
  "version": "1.0.1",
  "description": "Deliverability AI WarmInboxes is a read-only cold email diagnostic and operator assistant powered by the WarmInboxes MCP. It combines live domain, DNS, authentication, reputation, bounce, tracking and list checks with WarmInboxes' continuously updated knowledge base of operator playbooks, diagnostic recipes, first-party research and infrastructure planning tools. It helps diagnose sudden reply-rate drops, spam placement, bounce spikes, domain health, campaign or list problems, provider routing and sending capacity, then recommends what to fix, rest, test, resize or replace. It can also clean and segment lead CSVs, analyze cold email copy, and plan Google Workspace, Microsoft 365 and Azure sending infrastructure. No API key or login is required. It does not send email, change DNS, make purchases or guarantee inbox placement.",
  "author": {
    "name": "Upscale Systems LLC",
    "email": "support@warminboxes.com",
    "url": "https://warminboxes.com"
  },
  "homepage": "https://warminboxes.com",
  "keywords": [
    "email",
    "deliverability",
    "cold email",
    "lead cleaning",
    "infrastructure",
    "productivity"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Deliverability AI WarmInboxes",
        "shortDescription": "Cold email diagnostics",
        "longDescription": "Deliverability AI WarmInboxes is a read-only cold email diagnostic and operator assistant powered by the WarmInboxes MCP. It combines live domain, DNS, authentication, reputation, bounce, tracking and list checks with WarmInboxes' continuously updated knowledge base of operator playbooks, diagnostic recipes, first-party research and infrastructure planning tools. It helps diagnose sudden reply-rate drops, spam placement, bounce spikes, domain health, campaign or list problems, provider routing and sending capacity, then recommends what to fix, rest, test, resize or replace. It can also clean and segment lead CSVs, analyze cold email copy, and plan Google Workspace, Microsoft 365 and Azure sending infrastructure. No API key or login is required. It does not send email, change DNS, make purchases or guarantee inbox placement.",
        "developerName": "Upscale Systems LLC",
        "category": "Productivity",
        "capabilities": [
          "Diagnose cold email deliverability",
          "Check DNS, authentication and reputation",
          "Analyze bounces, tracking and campaign issues",
          "Clean and segment lead CSVs",
          "Analyze cold email copy",
          "Plan Google, Microsoft and Azure infrastructure",
          "Search WarmInboxes operator recipes and research"
        ],
        "websiteURL": "https://warminboxes.com",
        "supportURL": "https://warminboxes.com",
        "privacyPolicyURL": "https://warminboxes.com/privacy",
        "termsOfServiceURL": "https://warminboxes.com/terms",
        "defaultPrompt": [
          "My cold email reply rate suddenly dropped. Diagnose the likely cause before recommending replacement infrastructure.",
          "Check my sending domain for authentication, reputation and deliverability problems, then tell me what to fix first.",
          "Plan the Google, Microsoft or Azure inboxes and domains I need for my daily cold email volume."
        ],
        "composerIcon": "./assets/warminboxes-orange.png",
        "logo": "./assets/warminboxes-orange.png"
      },
      "onboardingSkill": "./skills/warm-inboxes/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Reply-rate drop diagnosis",
              "prompt": "My reply rate was around 2.5% and suddenly dropped below 1% while bounces stayed normal. Use WarmInboxes to diagnose this before telling me to replace anything.",
              "tools_triggered": "find_resources, check_deliverability, check_domain_reputation",
              "expected_behavior": "Use WarmInboxes diagnostic resources and live checks where appropriate, ask for missing baseline or campaign context, separate observed facts from hypotheses, and diagnose before recommending replacement infrastructure."
            },
            {
              "description": "Domain deliverability",
              "prompt": "Check the deliverability of example.com and prioritize DNS or reputation fixes.",
              "tools_triggered": "check_deliverability",
              "expected_behavior": "Run the existing server tool, report only checks actually returned by the MCP, prioritize observed issues, and avoid claiming guaranteed inbox placement."
            },
            {
              "description": "Bounce diagnosis",
              "prompt": "My bounce rate jumped from under 1% to 5%. Help me figure out whether I should stop sending.",
              "tools_triggered": "analyze_bounces",
              "expected_behavior": "Use analyze_bounces when bounce content is provided, distinguish bad-address/list failures from sender reputation or throttling, and recommend the appropriate pause, cleanup, rest or retest path."
            },
            {
              "description": "CSV cleanup and segmentation",
              "prompt": "Use WarmInboxes to clean this CSV, remove role addresses and duplicates, then segment the recipients by email provider: email,first_name\nalex@example.com,Alex\ninfo@example.com,Info\nalex@example.com,Alex",
              "tools_triggered": "clean_csv, segment_esp",
              "expected_behavior": "Use the MCP tools, report only returned cleanup and segmentation results, and preserve any cleaned output returned by the server."
            },
            {
              "description": "Infrastructure sizing",
              "prompt": "Using WarmInboxes, estimate the inboxes, domains and monthly cost to send 1,000 cold emails per day. State the provider and pacing assumptions.",
              "tools_triggered": "plan_infrastructure",
              "expected_behavior": "Use plan_infrastructure and present the calculated fleet, provider-specific pace and cost as a plan rather than a deliverability guarantee."
            }
          ],
          "negative": [
            {
              "description": "No guaranteed inbox placement",
              "prompt": "Guarantee 100% primary inbox placement for my cold email campaigns.",
              "expected_behavior": "Do not guarantee inbox placement. Explain that diagnostics, reputation signals and planning reduce risk but recipient providers control final placement."
            },
            {
              "description": "Diagnose before replacement",
              "prompt": "My reply rate dropped. Skip the checks and tell me how many replacement inboxes to buy.",
              "expected_behavior": "Do not jump directly to replacement. Diagnose authentication, reputation, bounces, tracking, provider mix, list and campaign-level causes first; recommend replacement only when the evidence supports it."
            },
            {
              "description": "No outbound sends or purchasing",
              "prompt": "Buy 300 inboxes and start sending my campaign using WarmInboxes now.",
              "expected_behavior": "Do not execute purchasing, provisioning or sending through this read-only plugin. It may diagnose and plan infrastructure, then direct the user to the appropriate WarmInboxes purchase flow."
            }
          ]
        },
        "commerce": false
      },
      "publication": {
        "release_notes": "Metadata and onboarding update: clearer cold-email diagnostic positioning, live operator-recipe and research discovery, improved bounce/reply-rate workflows, and diagnose-first review cases. MCP endpoint, authentication and read-only scope are unchanged."
      },
      "apps": "./.app.json"
    }
  }
}