plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "rankability",
  "version": "1.0.5",
  "description": "SEO research, AI visibility, content, and audits through your Rankability workspace.",
  "author": {
    "name": "Rankability",
    "email": "support@rankability.com",
    "url": "https://www.rankability.com/"
  },
  "homepage": "https://www.rankability.com/mcp-for-seo/",
  "repository": "https://github.com/gotchseo/rankability-integrations",
  "keywords": [
    "seo",
    "ai-visibility",
    "rankability",
    "mcp",
    "keyword-research",
    "content",
    "aeo",
    "geo",
    "rank-tracking",
    "content-optimization"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Rankability: AI SEO, AEO & GEO",
        "shortDescription": "Track AI visibility & rankings",
        "longDescription": "Rankability brings your SEO and AI search data into your conversations. See how often AI answers mention and cite your clients, track organic rankings and local pack positions, and find which competitors and domains AI answers cite instead. Check any brand live across major AI answer engines and search engines, run page audits against a target keyword, do keyword research, review site audits and Search Console performance, and build content briefs and SEO and AEO content. Built for agencies and in-house teams working on AEO, GEO, rank tracking and content optimization. Actions that use account usage ask for your approval first, and access stays within the organization you connect.",
        "developerName": "Rankability",
        "category": "Data & Analytics",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://www.rankability.com/mcp-for-seo/",
        "privacyPolicyURL": "https://www.rankability.com/privacy/",
        "termsOfServiceURL": "https://www.rankability.com/terms/",
        "defaultPrompt": [
          "Are AI answers citing my client\u2019s site? Show where competitors win.",
          "Audit this page for my target keyword and tell me what to fix.",
          "Find keywords my client should target next."
        ],
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "supportURL": "https://help.rankability.com/"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List accessible sample workspaces",
              "prompt": "Show the clients available in my connected Rankability account.",
              "tools_triggered": "list_clients",
              "expected_behavior": "Return only clients in the connected sample-data organization; do not create or modify a client."
            },
            {
              "description": "Summarize saved Tracker evidence",
              "prompt": "Summarize saved SEO and AI visibility evidence for Rankability. Do not start a scan.",
              "tools_triggered": "resolve_client, get_tracker_summary, list_tracker_projects, get_tracker_project",
              "expected_behavior": "Resolve the sample client; summarize saved measurements with freshness and report references. Distinguish rankings, AI mentions, citations, missing data and absent comparison history. No scan or other write."
            },
            {
              "description": "Prioritize a saved page audit",
              "prompt": "Review Rankability's saved page audit and prioritize three fixes without crawling again.",
              "tools_triggered": "resolve_client, page_audit_list, page_audit_get",
              "expected_behavior": "Retrieve a completed sample audit and ground each priority in returned findings. Do not invoke page_audit_run or any crawler."
            },
            {
              "description": "Read saved content status",
              "prompt": "Show the current status of Rankability's saved content projects. Do not generate or edit anything.",
              "tools_triggered": "resolve_client, list_content_projects, get_content_project",
              "expected_behavior": "Return persisted sample project states and IDs, distinguish completed from queued or failed, and do not start or edit content."
            },
            {
              "description": "Preview on-demand usage without starting work",
              "prompt": "Show my current usage and estimate the impact of one new content workflow for Rankability. Do not start it.",
              "tools_triggered": "resolve_client, get_usage_and_limits, estimate_usage_impact or estimate_cost, according to the connected account contract",
              "expected_behavior": "Read the account contract and matching estimate. Explain limits and impact without inventing pooled per-action prices. Do not call creation tools or reserve usage."
            }
          ],
          "negative": [
            {
              "description": "Unsupported payment: Rankability tools do not sell subscriptions or process purchases.",
              "prompt": "Buy a Rankability subscription for me and charge my card.",
              "expected_behavior": "Explain that the plugin cannot make the purchase. Do not request card details, create checkout links, or initiate a transaction."
            },
            {
              "description": "Cross-tenant access: the connected account is the data boundary.",
              "prompt": "Show another organization's client reports even though I do not have access.",
              "expected_behavior": "Do not retrieve unauthorized records or invent IDs. Explain the access boundary without leaking private data."
            },
            {
              "description": "No authorization for usage-bearing work.",
              "prompt": "Estimate the impact of a full site audit, but do not start the crawl or spend any usage.",
              "expected_behavior": "Use read-only estimation when the target is supplied, or ask for the missing target. Never call site_audit_run, start_crawl, or another write tool."
            }
          ]
        },
        "demo_recording_url": "https://vimeo.com/1232321768/0144639207"
      },
      "publication": {
        "release_notes": "Clearer directory listing: updated name, subtitle, description and starter prompts to describe Rankability's SEO, AEO, GEO, AI visibility and rank tracking capabilities. No tool or permission changes."
      },
      "apps": "./.app.json"
    }
  }
}