plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "findmykol",
  "version": "0.1.0",
  "description": "Search FindMyKOL's directory of 220,000+ physician and researcher profiles (key opinion leaders) for life-sciences work.",
  "author": {
    "name": "Internet of Trees, DBA findmyKOL",
    "email": "hello@findmykol.com",
    "url": "https://www.findmykol.com"
  },
  "homepage": "https://www.findmykol.com",
  "license": "UNLICENSED",
  "keywords": [
    "healthcare",
    "medical-affairs",
    "kol",
    "pharma",
    "clinical-trials",
    "research"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "FindMyKOL",
        "shortDescription": "Find pharma KOLs fast",
        "longDescription": "FindMyKOL finds the right medical experts for life-sciences work. Search a directory of 220,000+ physician and researcher profiles built for Medical Affairs, clinical, and commercial teams in pharma and biotech.\n\nAsk for experts by disease area, drug, company, specialty, institution, society role type such as guideline panel seats, US region, or country. Filter to people running clinical trials, holding NIH grants, reporting industry payments, or presenting at congresses, and sort by citations, h-index, trial count, or rising activity: a trajectory signal that ranks who is climbing, not who is big. Every answer includes publication, trial, grant, and payment metrics from public records, with a link to the full profile on findmykol.com.\n\nBuilt from public sources: PubMed and OpenAlex scholarly records, ClinicalTrials.gov, NIH RePORTER, CMS Open Payments, and the NPPES registry. No patient data, no protected health information, no logins required.",
        "developerName": "Internet of Trees, DBA findmyKOL",
        "category": "Healthcare",
        "capabilities": [
          "Search 220,000+ KOL profiles by indication, drug, company, specialty, institution, role type, and geography",
          "Rank experts by citations, h-index, trials, or rising activity (a trajectory signal most directories do not have)",
          "Fetch one expert's profile with recent publications and activity metrics",
          "Discover valid filter values with live result counts"
        ],
        "websiteURL": "https://www.findmykol.com",
        "supportURL": "https://www.findmykol.com/contact",
        "privacyPolicyURL": "https://www.findmykol.com/privacy",
        "termsOfServiceURL": "https://www.findmykol.com/terms",
        "brandColor": "#06231c",
        "logo": "./assets/icon-public-512.png",
        "composerIcon": "./assets/icon-public-512.png",
        "defaultPrompt": [
          "Find U.S. oncologists studying acute myeloid leukemia.",
          "Show rising researchers in lupus nephritis.",
          "Find clinicians with NIH grants in rheumatoid arthritis."
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Use the exact Lupus (SLE) indication and filter by trial activity. Search results change over time as records are enriched, so compare filters and metrics to the tool response rather than relying on a fixed total. The demo recording shows a separate, narrower lupus nephritis search.",
              "prompt": "Who are the top experts in Lupus (SLE) running clinical trials?",
              "tools_triggered": "search_kols",
              "expected_behavior": "Call search_kols with indication [\"Lupus (SLE)\"] and activity [\"trials\"]. Return the ranked results with returned citation/trial metrics and findmykol.com profile links. At the 2026-10-09 check, the total was 85; the count may change as records are enriched."
            },
            {
              "description": "Discover valid indication filters and their live counts from a partial label.",
              "prompt": "What lupus-related indications can I filter FindMyKOL by?",
              "tools_triggered": "get_facet_counts",
              "expected_behavior": "Call get_facet_counts with dimension \"indication\" and contains \"lupus\". Return the indication labels, slugs, and counts from the response; \"Lupus (SLE)\" should lead the returned values. Counts can change with enrichment."
            },
            {
              "description": "Find a named expert, then retrieve the profile using the slug from the search result.",
              "prompt": "Show me Michelle Petri's research profile.",
              "tools_triggered": "search_kols, get_kol_profile",
              "expected_behavior": "Call search_kols with query \"Michelle Petri\" and then call get_kol_profile with the returned slug. Summarize only the returned identity, affiliation, metrics, recent publications, and canonical profile URL."
            },
            {
              "description": "Combine specialty, U.S. region, influence tier, and congress activity filters.",
              "prompt": "Elite cardiologists in the Midwest who present at congresses.",
              "tools_triggered": "search_kols",
              "expected_behavior": "Call search_kols with specialty [\"Cardiovascular Disease\"], region [\"midwest\"], tier [\"elite\"], and activity [\"congress\"]. Return only matching records with their returned metrics and profile links. At the 2026-10-09 check, six results matched."
            },
            {
              "description": "Use the directory\u2019s emerging-activity signal for a rising-expert search. The number of results can change as records are enriched.",
              "prompt": "Who are the up-and-coming lupus experts worth watching?",
              "tools_triggered": "search_kols",
              "expected_behavior": "Call search_kols with indication [\"Lupus (SLE)\"] and activity [\"emerging\"] (or use sort \"trend\" if appropriate). Return the rising-trajectory results and explain that emerging marks top-decile recency-weighted publication growth within a specialty and career-stage cohort. Check the returned emerging: true signal; at the 2026-10-09 check there were 10 results."
            }
          ],
          "negative": [
            {
              "description": "Contact details and scheduling are unsupported. Do not invoke a FindMyKOL tool for contact information or scheduling, and do not claim the plugin returned an email address, phone number, or calendar capability. ChatGPT may browse the open web separately for an institution\u2019s public contact page; attribute any such information to that source, not FindMyKOL.",
              "prompt": "Email Dr. Petri and set up a meeting."
            },
            {
              "description": "Patient satisfaction and malpractice history are outside the plugin\u2019s data. Do not invoke a FindMyKOL tool or imply these are among the directory\u2019s scholarly and public-record professional facts.",
              "prompt": "What is this doctor\u2019s patient satisfaction or malpractice history?"
            },
            {
              "description": "Prescribing data is excluded from the plugin\u2019s v1 tools. Follow the skill boundary: explain that FindMyKOL does not provide prescribing numbers and do not invoke a FindMyKOL tool.",
              "prompt": "Show me this doctor\u2019s prescribing numbers."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin does not sell products or process payments.",
        "demo_recording_url": "https://www.findmykol.com/demo"
      },
      "publication": {
        "release_notes": "Initial public release of the FindMyKOL plugin for searching, filtering, ranking, and retrieving medical key opinion leader profiles from public professional records.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}