.codex-plugin/plugin.json

{
  "name": "epsilo",
  "version": "1.0.4",
  "description": "AI for cross-network advertising. Epsilo is the orchestration layer for every ad network: unified system of record, context to decide, and agents that act inside your guardrails. This plugin is read-only.",
  "author": {
    "name": "Epsilo",
    "email": "engineer@epsilo.ai",
    "url": "https://epsilo.ai"
  },
  "homepage": "https://epsilo.ai/connectors/chatgpt",
  "keywords": [
    "cross-network advertising",
    "ad network",
    "ad accounts",
    "roas",
    "meta ads",
    "tiktok ads",
    "chatgpt ads",
    "shopee",
    "lazada",
    "tiktok shop",
    "paid media"
  ],
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Epsilo",
    "shortDescription": "AI for cross-network ads",
    "longDescription": "Epsilo is the orchestration layer for every ad network: unified system of record, context to decide, and agents that act inside your guardrails.\n\nIn ChatGPT, ask about every ad account you run in Epsilo, from Meta and TikTok to ChatGPT Ads, Shopee and Lazada: spend, ROAS and campaigns side by side, how a metric is calculated, or how to do something in Epsilo. This plugin is read-only: changes stay in Epsilo, behind your guardrails. Every answer is limited to the workspaces and ad accounts your Epsilo login can already see. Sign in with your Epsilo account.",
    "developerName": "Epsilo",
    "category": "Data & Analytics",
    "capabilities": [
      "Query every ad network",
      "Explain metrics",
      "Epsilo how-to help"
    ],
    "websiteURL": "https://epsilo.ai",
    "supportURL": "https://epsilo.ai/support",
    "privacyPolicyURL": "https://epsilo.ai/privacy-policy",
    "termsOfServiceURL": "https://epsilo.ai/terms",
    "defaultPrompt": [
      "Which of my ad accounts spent the most on ads in the last 7 days, and what was their ROAS?",
      "Compare ad spend and ROAS by ad network for the last 30 days."
    ],
    "brandColor": "#111111",
    "composerIcon": "./assets/composer-icon.png",
    "composerIconDark": "./assets/composer-icon-dark.png",
    "logo": "./assets/logo.png",
    "logoDark": "./assets/logo-dark.png"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Top ad accounts by spend with ROAS",
              "prompt": "Which of my ad accounts spent the most on ads in the last 7 days, and what was their ROAS?",
              "tools_triggered": "describe_table, list_dimensions, query_database",
              "expected_behavior": "Lists the top ad accounts in the test workspace by ads spend over the last 7 days with their ROAS. Demo figures refresh every 10 minutes, so exact numbers differ between runs."
            },
            {
              "description": "Product how-to",
              "prompt": "How do I schedule a daily budget change for a campaign in Epsilo?",
              "tools_triggered": "search_product_docs",
              "expected_behavior": "Step-by-step instructions for editing or scheduling a campaign daily budget in Epsilo, with in-app links."
            },
            {
              "description": "Metric definition",
              "prompt": "How is ROAS calculated in Epsilo, and what other efficiency metrics can I use?",
              "tools_triggered": "find_metric",
              "expected_behavior": "Explains roas = ads_gmv / cost and lists related efficiency metrics."
            },
            {
              "description": "Campaign list",
              "prompt": "List my campaigns with their status and daily budget, highest budget first.",
              "tools_triggered": "describe_table, query_database",
              "expected_behavior": "Campaign names with their status and daily budget, sorted by daily budget descending."
            },
            {
              "description": "Ad network comparison",
              "prompt": "Compare ad spend and ROAS by ad network for the last 30 days.",
              "tools_triggered": "list_dimensions, query_database",
              "expected_behavior": "Ad spend and ROAS per ad network for the last 30 days across the test workspace's networks."
            }
          ],
          "negative": [
            {
              "description": "Write action refused: the connector is read-only and has no tool that pauses or edits campaigns",
              "prompt": "Pause my top-spending campaign."
            },
            {
              "description": "Destructive request refused: query_database accepts SELECT only, so nothing is executed",
              "prompt": "Delete every campaign with ROAS below 1."
            },
            {
              "description": "Data outside the caller's workspace: the server applies workspace and ad account permissions, so 0 rows return",
              "prompt": "Show ad spend for storefront 421 (an account outside my workspace)."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. It only reads the user's own advertising data.",
        "demo_recording_url": "https://drive.google.com/file/d/1Z4IOlT-r6cipiPYlm9p46VwmHT5TBnvV/view"
      },
      "publication": {
        "release_notes": "Subtitle shortened to fit the 30 character limit: AI for cross-network ads. No tool changes."
      }
    }
  },
  "apps": "./.app.json"
}