plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "serialhunt",
  "version": "1.0.0",
  "description": "US paper money serial numbers: whether a bill is worth keeping, the star note print run it came from, fancy serial patterns with exact odds, and the rarest star runs, from government production figures.",
  "author": {
    "name": "BigBalli",
    "email": "g@bigballi.com",
    "url": "https://bigballi.com"
  },
  "homepage": "https://bigballi.com/SerialHunt/connect",
  "repository": "https://github.com/BigBalli/serialhunt-mcp",
  "license": "MIT",
  "keywords": [
    "paper-money",
    "currency",
    "star-notes",
    "serial-numbers",
    "banknotes",
    "collecting"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "SerialHunt",
        "shortDescription": "Check US bill serial numbers",
        "longDescription": "SerialHunt tells you whether a US bill is worth keeping, from the serial number printed on it.\n\nGive it a serial and it reads the note the way a collector would: the Federal Reserve Bank, the series (worked out from the serial when it can be), and every fancy pattern in the eight digits, such as a radar, repeater, ladder, solid, binary, birthday or low serial, each with its exact odds counted across all 100,000,000 possible serials.\n\nFor a star note, the replacement note marked with a star in place of the last letter, it finds the exact print run the serial came from in the Bureau of Engraving and Printing's production figures and says how many star notes shared it. A star is only as scarce as its run, so this is the number that decides whether to keep one. It also says when a serial falls in a stretch the press skipped, so no such note was ever issued.\n\nAsk which star notes had the smallest print runs for a denomination, series or Federal Reserve Bank, what a pattern means and how rare it is, or which series the figures cover. The figures run from Series 1963 to the current series and update weekly from the Bureau's monthly reports, through the uspapermoney.info archive for older series.\n\nSerialHunt gives no prices and makes no authenticity claims, on purpose: no price guide for US paper money can be licensed, and a serial cannot show whether a note is genuine. Every answer links to the same result on the SerialHunt web lookup. Every tool is read-only and no account is needed.",
        "developerName": "BigBalli",
        "category": "Data & Analytics",
        "websiteURL": "https://bigballi.com/SerialHunt/lookup",
        "supportURL": "https://bigballi.com/SerialHunt/connect",
        "privacyPolicyURL": "https://bigballi.com/SerialHunt/privacy",
        "termsOfServiceURL": "https://bigballi.com/SerialHunt/terms",
        "defaultPrompt": [
          "Is star note A 032 12345 on a $1 Series 2017A rare?",
          "Which $2 star notes had the smallest print runs?",
          "What is a radar serial number, and how rare is it?"
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "capabilities": []
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Star note print run for one bill",
              "prompt": "I have a $1 bill from Series 2017A with serial A 032 12345 and a star at the end. Is it rare?",
              "tools_triggered": "check_serial",
              "expected_behavior": "Calls check_serial with the serial as a star note, denomination 1 and series 2017A, then reports that it came from a run of 250,000 star notes, which counts as very rare, quotes the comparison with other runs, gives no price and links the SerialHunt lookup page."
            },
            {
              "description": "Fancy pattern on a modern note, series worked out from the serial",
              "prompt": "Is MB 123 45678 C on a $20 bill a fancy serial number?",
              "tools_triggered": "check_serial",
              "expected_behavior": "Calls check_serial with the serial and denomination 20, reports that it is a ladder with odds of 1 in 16,666,666, that the series is 2013 worked out from the first letter, and that the bank is New York."
            },
            {
              "description": "Smallest star runs for a denomination",
              "prompt": "Which $2 star notes had the smallest print runs?",
              "tools_triggered": "find_star_runs",
              "expected_behavior": "Calls find_star_runs with denomination 2 and lists the smallest runs with their series, Federal Reserve Bank, notes printed, rarity band and serial range to watch for."
            },
            {
              "description": "What a pattern means and how rare it is",
              "prompt": "What is a radar serial number, and how rare is it?",
              "tools_triggered": "list_serial_patterns",
              "expected_behavior": "Calls list_serial_patterns and explains that a radar reads the same backwards as forwards, with 9,900 of the 100,000,000 possible serials, about 1 in 10,101."
            },
            {
              "description": "Which series the figures cover",
              "prompt": "Which series of $100 bills do your star note figures cover, and how up to date are they?",
              "tools_triggered": "get_coverage",
              "expected_behavior": "Calls get_coverage with denomination 100 and lists the covered series from 1963A to 2025, the date of the last update and the known gap of February and March 2026."
            }
          ],
          "negative": [
            {
              "description": "A price for a note, which SerialHunt deliberately does not give",
              "prompt": "How much money can I sell my 1928 $2 red seal bill for?"
            },
            {
              "description": "Authenticity, which a serial number cannot show",
              "prompt": "This $100 bill feels thin and the color looks off. Is it counterfeit?"
            },
            {
              "description": "Currency exchange, which the paper money tools look relevant to but do not cover",
              "prompt": "What is today's exchange rate from US dollars to euros?"
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://bigballi.com/SerialHunt/assets/review/serialhunt-chatgpt-demo.mp4"
      },
      "publication": {
        "release_notes": "Initial release: check a US bill's serial number for star note print runs and fancy patterns, find the rarest star runs, and see what the figures cover."
      },
      "apps": "./.app.json"
    }
  }
}