plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "kitabh",
  "version": "1.0.3",
  "description": "Analyze your Kitabh newsletter, articles and subscribers in ChatGPT.",
  "author": {
    "name": "Kitabh",
    "email": "support@kitabh.com",
    "url": "https://kitabh.com"
  },
  "homepage": "https://mcp.kitabh.com/guide",
  "keywords": [
    "newsletter",
    "writing",
    "arabic",
    "analytics",
    "subscribers"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Kitabh - \u0645\u0646\u0635\u0629 \u0643\u062a\u0627\u0628\u0629",
        "shortDescription": "Your newsletter, in numbers",
        "longDescription": "Kitabh is an Arabic platform for newsletters and long-form writing. This plugin lets a Kitabh writer analyze their own newsletter in ChatGPT: which articles were read the most, email open and click rates per issue, subscriber growth over time, unsubscribe patterns, comment activity and the best days to publish. Answers are based on the writer's own newsletters, articles, email results, followers and subscriber engagement. Writers can also save a new draft, and mark subscriber addresses that keep bouncing so they stop receiving email. Each writer can only access their own data. Requires a Kitabh account.",
        "developerName": "Kitabh - \u0645\u0646\u0635\u0629 \u0643\u062a\u0627\u0628\u0629",
        "category": "Data & Analytics",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://kitabh.com",
        "privacyPolicyURL": "https://mcp.kitabh.com/privacy",
        "termsOfServiceURL": "https://start.kitabh.com/en/terms_conditions-en",
        "defaultPrompt": [
          "Which of my Kitabh articles got the most views?",
          "How did my Kitabh newsletter subscribers grow over the last six months?",
          "\u0645\u0627 \u0623\u0641\u0636\u0644 \u064a\u0648\u0645 \u0644\u0646\u0634\u0631 \u0645\u0642\u0627\u0644\u0627\u062a\u064a \u0641\u064a \u0643\u062a\u0627\u0628\u0629\u061f"
        ],
        "brandColor": "#0000FF",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "supportURL": "https://mcp.kitabh.com/guide#faq"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List the writer's newsletters",
              "prompt": "Which newsletters do I have on Kitabh and how many subscribers does each have?",
              "tools_triggered": "get_my_newsletters",
              "expected_behavior": "Lists the newsletter \u00ab\u062f\u0641\u062a\u0631 \u0627\u0644\u062a\u062c\u0631\u0628\u0629\u00bb with about 1,240 subscribers, 12 articles and its email activity."
            },
            {
              "description": "Find the most-read articles",
              "prompt": "Which of my Kitabh articles got the most views?",
              "tools_triggered": "get_top_content",
              "expected_behavior": "Returns the articles ranked by views, led by \u00ab\u0644\u0645\u0627\u0630\u0627 \u0646\u0643\u062a\u0628 \u0641\u064a \u0632\u0645\u0646 \u0627\u0644\u0633\u0631\u0639\u0629\u061f\u00bb with 4,820 views."
            },
            {
              "description": "Subscriber growth over time",
              "prompt": "How did my newsletter subscribers grow over the last six months?",
              "tools_triggered": "get_my_newsletters, get_subscriber_growth",
              "expected_behavior": "Shows monthly new subscribers from May to October 2026 and the running total reaching about 1,240."
            },
            {
              "description": "Email performance",
              "prompt": "What are my email open and click rates, and which articles had the best open rate?",
              "tools_triggered": "get_email_performance, get_email_engagement_by_article",
              "expected_behavior": "Reports overall open and click rates and ranks articles by email open rate."
            },
            {
              "description": "Save a draft (demo account simulates it)",
              "prompt": "Create a draft in Kitabh titled \"Notes for next issue\" with three bullet points about my best-performing topics.",
              "tools_triggered": "create_draft",
              "expected_behavior": "Calls create_draft with the title and content; the review account replies that the draft was simulated and nothing was saved. Nothing is published."
            }
          ],
          "negative": [
            {
              "description": "Bulk deletion is not supported",
              "prompt": "Delete all of my newsletter subscribers."
            },
            {
              "description": "Another writer's data is not accessible",
              "prompt": "Show me the subscriber list of another writer's newsletter on Kitabh."
            },
            {
              "description": "Publishing is not supported",
              "prompt": "Publish my latest draft on Kitabh right now."
            }
          ]
        },
        "demo_recording_url": "https://mcp.kitabh.com/review/kitabh-chatgpt-walkthrough.mp4"
      },
      "publication": {
        "release_notes": "First release: read analytics for Kitabh newsletters, articles, email performance and subscribers; save drafts.",
        "translations": {
          "ar-SA": {
            "subtitle": "\u0646\u0634\u0631\u062a\u0643 \u0628\u0627\u0644\u0623\u0631\u0642\u0627\u0645",
            "description": "\u0627\u0631\u0628\u0637 \u062d\u0633\u0627\u0628\u0643 \u0641\u064a \u0643\u062a\u0627\u0628\u0629 \u0648\u0627\u0633\u0623\u0644 ChatGPT \u0639\u0646 \u0646\u0634\u0631\u062a\u0643: \u0623\u064a \u0645\u0642\u0627\u0644\u0627\u062a\u0643 \u0642\u064f\u0631\u0626 \u0623\u0643\u062b\u0631\u060c \u0648\u0645\u0639\u062f\u0644\u0627\u062a \u0641\u062a\u062d \u0628\u0631\u064a\u062f\u0643 \u0648\u0627\u0644\u0646\u0642\u0631 \u0639\u0644\u064a\u0647\u060c \u0648\u0646\u0645\u0648 \u0645\u0634\u062a\u0631\u0643\u064a\u0643\u060c \u0648\u0623\u0646\u0645\u0627\u0637 \u0625\u0644\u063a\u0627\u0621 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u060c \u0648\u0623\u0641\u0636\u0644 \u0623\u064a\u0627\u0645 \u0627\u0644\u0646\u0634\u0631. \u0627\u0644\u0625\u062c\u0627\u0628\u0627\u062a \u0645\u0646 \u0628\u064a\u0627\u0646\u0627\u062a\u0643 \u0623\u0646\u062a. \u0648\u064a\u0645\u0643\u0646\u0643 \u0623\u064a\u0636\u064b\u0627 \u062d\u0641\u0638 \u0645\u0633\u0648\u062f\u0629 \u062c\u062f\u064a\u062f\u0629. \u0643\u0644 \u0643\u0627\u062a\u0628 \u064a\u0635\u0644 \u0625\u0644\u0649 \u0628\u064a\u0627\u0646\u0627\u062a\u0647 \u0641\u0642\u0637."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}