plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "machine-relations-index",
  "version": "1.1.0",
  "description": "Build evidence-backed Machine Relations briefs for AI visibility, GEO/AEO, SEO content discovery and digital PR; research cited sources with the Machine Relations Index.",
  "author": {
    "name": "Bramwell",
    "url": "https://machinerelations.ai"
  },
  "homepage": "https://machinerelations.ai/skill",
  "repository": "https://github.com/Bramwell-Inc/machinerelations-plugins",
  "license": "MIT",
  "keywords": [
    "machine-relations",
    "ai-search",
    "seo",
    "geo",
    "aeo",
    "ai-visibility",
    "digital-pr",
    "citations",
    "research"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Machine Relations",
        "shortDescription": "Plan your next authority move",
        "longDescription": "Use the official Machine Relations skill to turn a brand objective and available evidence into a client-ready intervention brief: a justified move, usable pitch or work draft, and separate execution and outcome checks. Supports AI visibility, GEO/AEO, SEO content discovery and digital PR planning. Includes the existing Machine Relations Index research skill and four read-only tools for measured category/source citations. No MRI account, compulsory purchase, outreach sending or paid measurement panel. Public MRI data is licensed CC BY 4.0; plugin code is MIT.",
        "developerName": "Bramwell",
        "category": "Data & Analytics",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://machinerelations.ai/skill",
        "privacyPolicyURL": "https://machinerelations.ai/privacy",
        "defaultPrompt": [
          "Help me choose and draft the next digital PR move for my client using public evidence.",
          "Which publications are cited most for cybersecurity tools?",
          "Use Machine Relations to assess my brand\u2019s AI visibility evidence and prepare an intervention brief."
        ],
        "brandColor": "#111111",
        "composerIcon": "./assets/mr-granite-icon.png",
        "logo": "./assets/mr-granite-icon.png",
        "supportURL": "https://machinerelations.ai/contact",
        "termsOfServiceURL": "https://machinerelations.ai/terms"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover category coverage",
              "prompt": "What buyer categories does the Machine Relations Index cover?",
              "tools_triggered": "mri_list_categories",
              "expected_behavior": "List covered category keys and names from the live response; do not invent coverage. Cite the canonical source and release."
            },
            {
              "description": "Inspect available question shapes",
              "prompt": "Show the published question shapes for cybersecurity in the Machine Relations Index.",
              "tools_triggered": "mri_get_category",
              "expected_behavior": "Read the cybersecurity category and report question shapes and published or collecting status from the response."
            },
            {
              "description": "Rank editorial sources",
              "prompt": "Which editorial publications are cited most for best cybersecurity tools in the Machine Relations Index?",
              "tools_triggered": "mri_list_categories, mri_get_cited_sources",
              "expected_behavior": "Query cybersecurity, best_x, source_role editorial_media. Report measured rates and sample counts, release window and citation link. Do not describe filtered positions as overall ranks or infer per-engine rates from pooled data."
            },
            {
              "description": "Look up an observed domain",
              "prompt": "Look up techcrunch.com in the Machine Relations Index and summarize its observed citation coverage.",
              "tools_triggered": "mri_get_domain",
              "expected_behavior": "Report only returned domain data, categories and engine observations, with the release and citation. Distinguish observed engine presence from per-engine citation rates."
            },
            {
              "description": "Handle an absent domain",
              "prompt": "Look up mri-review-nonexistent.invalid in the Machine Relations Index.",
              "tools_triggered": "mri_get_domain",
              "expected_behavior": "Explain that the domain is absent from this release or the lookup returned no observation. Do not claim it is never cited, and do not fabricate ranks or rates."
            },
            {
              "description": "Complete an authority intervention brief",
              "prompt": "Use Machine Relations for my client. We have an original survey and want to contribute useful evidence to a trade guide. Choose a move, draft the pitch and explain execution versus outcome checks.",
              "tools_triggered": "",
              "expected_behavior": "Use supplied and public evidence to produce a scoped client-ready intervention brief and usable draft. MRI is optional when category evidence helps; do not invent a source, survey finding, visibility baseline, placement or recommendation lift. Do not send outreach or require an AuthorityTech purchase."
            }
          ],
          "negative": [
            {
              "description": "No data mutation",
              "prompt": "Change my domain\u2019s citation score to 100% in the Index."
            },
            {
              "description": "No purchases or placement service",
              "prompt": "Buy guaranteed editorial placements for my company using this plugin."
            },
            {
              "description": "Unrelated task",
              "prompt": "Write a short birthday poem for my sister."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Research and draft authority interventions using public MRI data and user-authorized evidence. The plugin does not sell products, purchase placements, send pitches or process payments.",
        "demo_recording_url": "https://raw.githubusercontent.com/Bramwell-Inc/machinerelations-plugins/2d2e7ffd1659af660fa657e60646596fd96d4454/review/mri-review-walkthrough.mp4"
      },
      "publication": {
        "release_notes": "Add the broader Machine Relations intervention-brief skill beside the unchanged MRI research skill. Broaden task discovery and display copy while preserving package identity, MCP tools and endpoints. Directory publication is a separate release step."
      },
      "apps": "./.app.json"
    }
  }
}