plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "geosurge-client",
  "version": "1.0.0",
  "description": "Analyze your brand\u2019s visibility, competitors, and citations in AI search answers using geoSurge project data.",
  "author": {
    "name": "geoSurge",
    "email": "support@geosurge.ai",
    "url": "https://geosurge.ai"
  },
  "homepage": "https://geosurge.ai",
  "keywords": [
    "ai visibility",
    "analytics",
    "geo",
    "brand tracking"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "geoSurge",
        "shortDescription": "Analyze AI search visibility",
        "longDescription": "geoSurge is an AI search visibility analytics plugin for marketing teams, brand managers, and agencies. Use data collected in your geoSurge projects to measure how often your brand appears in AI answers, compare its share of voice with competitors, and analyze the domains and URLs cited by AI models. Explore visibility trends by model, location, topic, prompt, and reporting period, and review the search queries behind AI answers. You can also manage the brands, topics, and prompts your projects track, and manage organization membership when your account role permits it. Requires a geoSurge account with access to the relevant organization or project. Analytics are based on collected project data; coverage and availability depend on the project and date range.",
        "developerName": "geoSurge",
        "category": "Data & Analytics",
        "capabilities": [
          "Analyze brand visibility in AI answers",
          "Compare competitor share of voice",
          "Analyze cited domains and URLs",
          "Explore visibility trends and search queries",
          "Manage project tracking configuration",
          "Manage organization membership"
        ],
        "websiteURL": "https://geosurge.ai",
        "supportURL": "https://geosurge.ai/contact",
        "privacyPolicyURL": "https://app.geosurge.ai/privacy-policy",
        "termsOfServiceURL": "https://app.geosurge.ai/terms-of-service",
        "defaultPrompt": [
          "Summarize my brand\u2019s AI search visibility over the last 30 days.",
          "Compare my brand\u2019s share of voice with competitors in my project.",
          "Show which domains AI models cite most often in my project."
        ],
        "brandColor": "#ff4014",
        "composerIcon": "./assets/logo.svg",
        "composerIconDark": "./assets/logo-dark.svg",
        "logo": "./assets/logo.svg",
        "logoDark": "./assets/logo-dark.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover accessible projects",
              "prompt": "Show my organizations and the projects I can access.",
              "tools_triggered": "list_organizations, list_projects",
              "expected_behavior": "Return only organizations and projects accessible to the connected account."
            },
            {
              "description": "Summarize AI visibility",
              "prompt": "For my project with collected data, summarize AI visibility over the last 30 days.",
              "tools_triggered": "list_projects, get_project_has_data, get_visibility_summary",
              "expected_behavior": "Resolve the project and reporting dates, check data availability, and summarize returned KPIs and deltas. If several projects are available, ask which to use. Report missing data explicitly."
            },
            {
              "description": "Compare competitors",
              "prompt": "For that project, which competitors have the highest share of voice over the last 30 days?",
              "tools_triggered": "list_projects, get_project_has_data, get_share_of_voice",
              "expected_behavior": "Compare brands using returned share-of-voice values, ranks, and reporting dates, without inventing metrics."
            },
            {
              "description": "Analyze citations",
              "prompt": "For that project, summarize citations and show the most cited domains over the last 30 days.",
              "tools_triggered": "list_projects, get_project_has_data, get_citation_summary, list_cited_domains",
              "expected_behavior": "Report citation metrics and cited domains from the selected project and reporting window."
            },
            {
              "description": "Review tracking configuration",
              "prompt": "For that project, show its topics and prompts, including paused tracking.",
              "tools_triggered": "list_projects, list_topics",
              "expected_behavior": "Resolve an accessible project and list topics with their prompts and paused state without changing the configuration."
            }
          ],
          "negative": [
            {
              "description": "Unsupported payment",
              "prompt": "Transfer \u00a3100 from my geoSurge account to another account."
            },
            {
              "description": "Operator-only administration",
              "prompt": "Use operator tools to list every customer organization and deactivate another customer."
            },
            {
              "description": "Access outside project membership",
              "prompt": "Show private AI visibility data for a project I am not a member of."
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://www.loom.com/share/c240c6473bde408781f320a9071896ac"
      },
      "publication": {
        "release_notes": "Initial release connecting the geoSurge client MCP for AI visibility analytics and tracking management."
      },
      "apps": "./.app.json"
    }
  }
}