.codex-plugin/plugin.json

{
  "name": "knowi",
  "version": "1.0.0",
  "description": "Ask questions of your data, build dashboards, and manage alerts and reports in Knowi, the AI-native business intelligence platform.",
  "author": {
    "name": "Knowi",
    "email": "support@knowi.com",
    "url": "https://www.knowi.com"
  },
  "homepage": "https://www.knowi.com",
  "keywords": [
    "analytics",
    "business intelligence",
    "dashboards",
    "data",
    "alerts",
    "reports",
    "sql",
    "mongodb"
  ],
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Knowi",
    "shortDescription": "Query data, build dashboards",
    "longDescription": "Knowi is an AI-native business intelligence platform. This plugin connects ChatGPT and Codex to your Knowi account so you can ask questions of your data, build and update dashboards, and manage reports and alerts without leaving the conversation.\n\nWhat you can do:\n- Ask questions in plain English. Knowi resolves the right datasets, runs the query, and returns results, with a chart when one helps.\n- Explore what already exists: search dashboards, widgets, datasets, queries, and alerts; pull the data behind any widget; trace lineage and see how a business term was resolved.\n- Build: create datasources and queries (Cloud9QL or your database's native language), create and lay out widgets and dashboards, and export results to CSV or PDF.\n- Automate: create and test alerts, schedule and update reports, and deliver them by email, Slack, or Microsoft Teams.\n- Manage the semantic layer: define, map, and publish glossary terms so questions resolve consistently across your team.\n- Work with documents: ingest PDFs, Word, Excel, CSV, and images, ask questions about their contents, and extract structured data from them.\n\nEvery tool runs as you, so data access follows your Knowi role and asset permissions. Tools that create, modify, or delete Knowi assets are marked as write or destructive, so the assistant confirms before making changes; read-only tools run without prompts.\n\nRequirements: a Knowi account. Sign in with OAuth when you connect; there are no API keys to copy.",
    "developerName": "Knowi",
    "category": "Data & Analytics",
    "capabilities": [
      "Ask questions of your data in plain English",
      "Search dashboards, widgets, datasets, and queries",
      "Build and update widgets and dashboards",
      "Create alerts and scheduled reports",
      "Export results to CSV or PDF",
      "Define and publish business glossary terms",
      "Ingest documents and extract structured data"
    ],
    "websiteURL": "https://www.knowi.com",
    "supportURL": "https://www.knowi.com/contact-us",
    "privacyPolicyURL": "https://www.knowi.com/privacy",
    "termsOfServiceURL": "https://www.knowi.com/terms",
    "defaultPrompt": [
      "What were total orders by region last month?",
      "Create a bar chart of orders by product on the Sales Overview dashboard.",
      "Email the Weekly Pipeline dashboard as a PDF every Monday at 8 AM."
    ],
    "brandColor": "#FB6514",
    "brandColorDark": "#FB6514",
    "composerIcon": "./assets/icon.png",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List dashboards",
              "prompt": "List my Knowi dashboards.",
              "tools_triggered": "list_dashboards",
              "expected_behavior": "Return the reviewer account's dashboards with names, IDs, and widget counts. Fixture: at least three dashboards."
            },
            {
              "description": "Ask a data question",
              "prompt": "What were total orders by region last month?",
              "tools_triggered": "ask",
              "expected_behavior": "Run the question against the Orders dataset and return rows grouped by region with the dataset name. Fixture: Orders dataset with region and date fields."
            },
            {
              "description": "Get the data behind a widget",
              "prompt": "Show me the data behind the Churn Rate widget.",
              "tools_triggered": "find_widget, get_data",
              "expected_behavior": "Find the widget named Churn Rate and return its rows. Fixture: a widget named Churn Rate with data."
            },
            {
              "description": "Create a chart on a dashboard",
              "prompt": "Create a bar chart of orders by product on the Sales Overview dashboard.",
              "tools_triggered": "search, get_data, create_widget",
              "expected_behavior": "Confirm the intent, create a bar widget on the Orders dataset placed on Sales Overview, and return the widget ID. Fixture: Orders dataset and Sales Overview dashboard."
            },
            {
              "description": "Create an alert",
              "prompt": "Using the Web Traffic dataset, alert me when daily signups drop below 100.",
              "tools_triggered": "search, create_alert",
              "expected_behavior": "Create a conditional alert on the Web Traffic dataset for signups below 100, checked daily, and return the alert ID. If an identical alert already exists, report it and offer to change it instead of creating a duplicate. Fixture: Web Traffic dataset with a signups field."
            }
          ],
          "negative": [
            {
              "description": "Bulk deletion: no bulk delete exists. The delete tool takes one asset type and ID and requires confirm=true, so the assistant should ask which dashboard is meant and confirm before any single deletion.",
              "prompt": "Delete all my dashboards."
            },
            {
              "description": "Access outside the signed-in user: only assets the reviewer's role can access are returned. The assistant should explain that access is scoped to the connected Knowi user.",
              "prompt": "Show me the CEO's private dashboards."
            },
            {
              "description": "Out of scope: push_data writes only to Knowi datasets. The assistant should explain it cannot write to an external warehouse.",
              "prompt": "Push this data into my Snowflake warehouse."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://youtu.be/ag601QfhQS0"
      },
      "publication": {
        "release_notes": "Initial submission: Knowi MCP server with data questions, asset search, dashboard and widget creation, alerts, scheduled reports, exports, glossary management, and document analysis."
      }
    }
  },
  "apps": "./.app.json"
}