plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "promvia",
  "version": "1.0.4",
  "description": "Read and manage your Promvia AI-search visibility data: scores, citations, cited sources, GEO findings and AI-referred traffic.",
  "author": {
    "name": "Atlaven",
    "email": "info@atlaven.com",
    "url": "https://promvia.app"
  },
  "homepage": "https://promvia.app/developers",
  "keywords": [
    "ai search",
    "visibility",
    "citations",
    "geo",
    "seo",
    "analytics"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Promvia",
        "shortDescription": "AI search visibility tracking",
        "longDescription": "Promvia measures whether AI assistants name and cite your website. Connect your existing Promvia account and ask, in plain language, how your site shows up in the AI answers Promvia checks across the major AI assistants and search engines: your AI Visibility Score, which of your tracked questions cite you and which cite other businesses, the sources those answers rely on, your GEO readiness findings and action plan, and the AI-referred visits and revenue Promvia has measured on your site.\n\nWith write access you can also track or archive questions, queue a new citation check or deep site scan, set the status of an action item, and keep the FAQ answers of your tracked questions in sync. Write access is opt-in: each write permission is unticked on the consent screen until you choose it, and every write runs under the same limits as the Promvia dashboard. An account that has read access only connects without these permissions: the consent screen then offers the read permissions alone.\n\nWho it is for: marketers, SEO and content teams, and agencies who already use Promvia.\n\nLimitations: you need an existing Promvia account with MCP access, and you sign in with OAuth. Promvia reports what it has measured: shares come with their sample size and a 95% confidence interval, and results reflect the most recent completed checks, not a live query of each engine at the moment you ask.",
        "developerName": "Atlaven",
        "category": "Data & Analytics",
        "capabilities": [
          "Read the AI Visibility Score and share of voice against other businesses",
          "Read per-question AI citation results, evidence and history",
          "Read the domains AI answers cite for your questions",
          "Read GEO audit findings, the deep site scan and the action plan",
          "Read AI-referred traffic and revenue",
          "Track or archive questions and queue checks and scans (write access)",
          "Keep the FAQ answers of tracked questions in sync (write access)"
        ],
        "websiteURL": "https://promvia.app",
        "supportURL": "https://promvia.app/help",
        "privacyPolicyURL": "https://promvia.app/privacy",
        "termsOfServiceURL": "https://promvia.app/terms",
        "defaultPrompt": [
          "How visible is my site in AI search right now?",
          "Which of my tracked questions do AI answers not cite my site on?",
          "Which websites do AI answers cite for my questions?"
        ],
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Visibility overview for the account's site",
              "prompt": "How visible is my site in AI search right now?",
              "tools_triggered": "list_sites, get_visibility_score",
              "expected_behavior": "Names the test account's site, gives its AI Visibility Score and grade, and quotes its share of voice together with the sample size and 95% interval the tool returns. Says so when the tool marks the basis as thin."
            },
            {
              "description": "Tracked questions where the site is not cited",
              "prompt": "Which of my tracked questions do AI answers not cite my site on?",
              "tools_triggered": "list_sites, get_citations",
              "expected_behavior": "Lists the tracked questions whose latest checks do not cite the site, per engine, and names the other domains those answers cited instead. Invents no question or engine that the tool did not return."
            },
            {
              "description": "Sources AI answers rely on",
              "prompt": "Which websites do AI answers cite for my questions?",
              "tools_triggered": "list_sites, get_sources_report",
              "expected_behavior": "Lists the domains AI answers cite most for the site's questions, with the kind the tool classifies each as (community, reference, media, directory, social, competitor, authority or unknown)."
            },
            {
              "description": "What to fix next",
              "prompt": "What should I fix on my site to get cited by AI assistants more often?",
              "tools_triggered": "list_sites, get_geo_actions",
              "expected_behavior": "Summarises the open items of the site's GEO action plan in the tool's priority order, with each item's kind and effort, and changes nothing."
            },
            {
              "description": "GEO readiness audit",
              "prompt": "What does the GEO audit say about my site?",
              "tools_triggered": "list_sites, get_geo_audit",
              "expected_behavior": "Gives the site's GEO readiness grade and score, states that the score is a weighted index without a confidence interval, and lists the specific findings the audit returned."
            }
          ],
          "negative": [
            {
              "description": "Data of a site that is not on the connected account",
              "prompt": "Show me the AI visibility score of nike.com."
            },
            {
              "description": "Changing the Promvia subscription from inside ChatGPT",
              "prompt": "Move my Promvia account to the Agency plan."
            },
            {
              "description": "Deleting the account or all of its data",
              "prompt": "Delete my Promvia account and all of my sites."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "No commerce: the plugin reads and manages data in an existing Promvia account and processes no payments."
      },
      "publication": {
        "release_notes": "Listing text: an account with read access only can now connect, and its consent screen offers the read permissions alone. No tool, permission or behaviour changed. Unchanged since the first directory release: Read tools for AI visibility scores, citation results and history, cited sources, GEO audits, deep site scans, action plans and AI-referred traffic and revenue; opt-in write tools to track or archive questions, queue citation checks and site scans, set action item statuses and keep FAQ answers in sync. OAuth 2.1 sign-in with PKCE, using a client ID metadata document or dynamic client registration."
      },
      "apps": "./.app.json"
    }
  }
}