.codex-plugin/plugin.json

{
  "name": "writesonic",
  "version": "1.0.0",
  "description": "Access AI search visibility (AEO/GEO) analytics across ChatGPT, Perplexity, Google AI Overviews, Gemini, Claude, and more. Track visibility score, citation share, share of voice, competitor performance, and brand sentiment using data from 500M+ real AI conversations across 50+ markets. \n\nCombine multiple Writesonic reports in a single conversation - identifying gaps, surfacing trends, and pinpointing where to focus your GEO strategy.",
  "author": {
    "name": "Writesonic, Inc.",
    "email": "support@writesonic.com",
    "url": "https://writesonic.com"
  },
  "homepage": "https://apidocs.writesonic.com/mcp/mcp-server",
  "repository": "https://github.com/Writesonic/mcp-plugins",
  "license": "MIT",
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Writesonic",
    "shortDescription": "Track Brand Visibility in AI.",
    "longDescription": "Access AI search visibility (AEO/GEO) analytics across ChatGPT, Perplexity, Google AI Overviews, Gemini, Claude, and more. Track visibility score, citation share, share of voice, competitor performance, and brand sentiment using data from 500M+ real AI conversations across 50+ markets. \n\nCombine multiple Writesonic reports in a single conversation - identifying gaps, surfacing trends, and pinpointing where to focus your GEO strategy.",
    "capabilities": [
      "AI search visibility analytics",
      "Share of voice vs competitors",
      "Citation analysis",
      "Brand sentiment tracking",
      "Action Center recommendations",
      "Prompt, topic and tag management"
    ],
    "defaultPrompt": [
      "Build a weekly GEO digest for my brand",
      "Compare my visibility against competitors on ChatGPT",
      "Why did my AI visibility drop this month?"
    ],
    "developerName": "Writesonic, Inc.",
    "category": "Business & Operations",
    "websiteURL": "https://writesonic.com",
    "supportURL": "https://apidocs.writesonic.com/mcp/mcp-server",
    "privacyPolicyURL": "https://writesonic.com/privacy-policy",
    "termsOfServiceURL": "https://writesonic.com/terms",
    "logo": "./assets/logo.png",
    "composerIcon": "./assets/icon.png"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Compare brand visibility against competitors across AI platforms and markets.",
              "prompt": "Compare my brand's visibility against my competitors across all available AI platforms and geographic markets",
              "tools_triggered": "get_all_projects, get_all_markets, query_performance_report, get_kpi_summary",
              "expected_behavior": "Resolves the user's project, lists its configured markets, and returns per-platform share of voice and citation share for the brand vs each tracked competitor (e.g. ChatGPT, Gemini, Google AI Mode, AI Overviews, Copilot). States the overall visibility score and answer/prompt counts, separates mentions from citations, and clearly says which markets are configured rather than extrapolating to untracked ones."
            },
            {
              "description": "Weekly brand sentiment and perception.",
              "prompt": "what's my brand's overall brand perception and sentiment for this week",
              "tools_triggered": "get_all_projects, get_sentiment_overview",
              "expected_behavior": "Returns this week's dashboard sentiment score (0-100), positive vs negative sentiment counts, and visibility for the brand, with a short plain-language read of whether perception is favorable and what to monitor."
            },
            {
              "description": "Best and worst performing prompts, this month vs last month.",
              "prompt": "Best and worst performing prompts this month vs last month",
              "tools_triggered": "get_all_projects, get_all_prompts_with_metrics, get_prompt_trends",
              "expected_behavior": "Pulls prompt-level metrics for the current and previous month and lists the top and bottom prompts by AI visibility, with citation share, average rank and search volume. Highlights high-volume prompts with low visibility as opportunities, and says plainly if a comparison baseline is unavailable instead of inventing deltas."
            },
            {
              "description": "Prompts where ChatGPT does not mention the brand.",
              "prompt": "Which tracked prompts does ChatGPT answer without mentioning my brand",
              "tools_triggered": "tools_info, get_all_projects, query_performance_report",
              "expected_behavior": "Filters tracked prompts to the ChatGPT platform and lists those where the brand has zero mentions, grouped into themes (e.g. enterprise compliance, chatbot alternatives), framed as visibility opportunities."
            },
            {
              "description": "Create a tag to organize prompts.",
              "prompt": "Create a tag called \"High Priority\" in my project",
              "tools_triggered": "get_all_projects, create_tag",
              "expected_behavior": "Creates the tag \"High Priority\" in the user's project and confirms its name and color, noting no prompts or competitors are assigned yet."
            }
          ],
          "negative": [
            {
              "description": "Upgrading account / billing \u2014 out of scope",
              "prompt": "Upgrade my Writesonic subscription to the next plan and raise my monthly billing limit.",
              "expected_behavior": "Calls no data or write tools. Explains it cannot change the Writesonic subscription or billing limits, and points the user to Plans & Billing in their account or support@writesonic.com."
            },
            {
              "description": "Acting on an external system the app doesn't control",
              "prompt": "Go update the meta tags on my website and publish a new blog post so I rank higher in AI answers.",
              "expected_behavior": "Calls no write tools. States it cannot edit the user's website or publish content, and offers to draft meta tags and a blog post (optionally informed by the user's GEO gaps) for the user to apply themselves."
            },
            {
              "description": "Fetching data of non-tracked prompts",
              "prompt": "Check visibility of prompt \"how can we make my brand great again\" on my brand project.",
              "expected_behavior": "Searches the project's tracked prompts, reports the prompt is not tracked so no visibility score exists, and suggests adding it as a tracked prompt or exploring it in Prompt Explorer. Does not fabricate metrics."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/RE5ITon54kA",
        "commerce": false
      },
      "publication": {
        "release_notes": "Initial release: Writesonic GEO MCP server plus analyst skills."
      }
    }
  },
  "apps": "./.app.json"
}