plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "kalenteri-online",
  "version": "1.0.6",
  "description": "Finnish calendar data: public holidays, flag days and calendar searches.",
  "author": {
    "name": "Mammuth",
    "email": "info@kalenteri.online",
    "url": "https://kalenteri.online"
  },
  "homepage": "https://kalenteri.online",
  "keywords": [
    "kalenteri",
    "Suomi",
    "pyh\u00e4p\u00e4iv\u00e4t",
    "arkipyh\u00e4t",
    "liputusp\u00e4iv\u00e4t",
    "teemap\u00e4iv\u00e4t",
    "juhlap\u00e4iv\u00e4t",
    "calendar",
    "Finland",
    "public holidays",
    "flag days"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Kalenteri.online",
        "shortDescription": "Finnish calendar data",
        "longDescription": "Find Finnish public holidays, flag days and other calendar occasions by date, date range or part of a name. Results include dates, names and source information. Available years and details depend on your access permissions. Name days and personal calendar entries are not included. This plugin retrieves calendar information and does not create reminders or modify calendars.",
        "developerName": "Mammuth",
        "category": "Productivity",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://kalenteri.online",
        "supportURL": "https://kalenteri.online/tietoa",
        "privacyPolicyURL": "https://kalenteri.online/tietosuojaseloste",
        "termsOfServiceURL": "https://kalenteri.online/kayttoehdot",
        "logo": "./assets/logo.svg",
        "composerIcon": "./assets/logo.svg",
        "defaultPrompt": [
          "Mitk\u00e4 ovat Suomen viralliset pyh\u00e4p\u00e4iv\u00e4t t\u00e4n\u00e4 vuonna?",
          "N\u00e4yt\u00e4 t\u00e4m\u00e4n kuukauden viralliset ja vakiintuneet liputusp\u00e4iv\u00e4t.",
          "Mit\u00e4 kalenterip\u00e4ivi\u00e4 on t\u00e4n\u00e4\u00e4n?"
        ]
      },
      "review": {
        "demo_recording_url": "https://kalenteri.online/assets/video/ChatGPT-TestCases-1080p.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Anonymous single-day lookup for Finland's Independence Day in the current Finnish calendar year. Run without a connected account.",
              "prompt": "Hae t\u00e4m\u00e4n vuoden joulukuun 6. p\u00e4iv\u00e4n kalenteritiedot Kalenteri.online-palvelusta ja n\u00e4yt\u00e4 kaikki palautuneet kalenterip\u00e4iv\u00e4t.",
              "tools_triggered": "get_day",
              "expected_behavior": "Call get_day with date set to December 6 of the current year in Europe/Helsinki. Return the actual entries, including Itsen\u00e4isyysp\u00e4iv\u00e4, and any other entries returned for that date. Cite Kalenteri.online. Do not require sign-in or add name days."
            },
            {
              "description": "Anonymous public-holiday lookup across the current Finnish calendar year. Run without a connected account.",
              "prompt": "N\u00e4yt\u00e4 Suomen t\u00e4m\u00e4n vuoden viralliset pyh\u00e4p\u00e4iv\u00e4t Kalenteri.online-palvelusta. \u00c4l\u00e4 lis\u00e4\u00e4 aattop\u00e4ivi\u00e4 tai kaikkia sunnuntaita.",
              "tools_triggered": "get_calendar_days",
              "expected_behavior": "Call get_calendar_days for January 1 through December 31 of the current year in Europe/Helsinki with type=publicHolidays and without holidayObservances or holidaySundays. Show the returned holidays with dates and cite Kalenteri.online. Do not require sign-in or add unrelated calendar occasions."
            },
            {
              "description": "Anonymous case-insensitive name search with list output across the current Finnish calendar year. Run without a connected account.",
              "prompt": "Hae t\u00e4m\u00e4n vuoden kalenterista nimell\u00e4 ITSEN\u00c4ISYYS ja n\u00e4yt\u00e4 osumat p\u00e4iv\u00e4m\u00e4\u00e4rineen listana Kalenteri.online-palvelusta.",
              "tools_triggered": "search_calendar",
              "expected_behavior": "Call search_calendar with q=ITSEN\u00c4ISYYS, format=list and the current year's January 1 through December 31 boundaries in Europe/Helsinki. Return actual matching names and dates, including Itsen\u00e4isyysp\u00e4iv\u00e4 on December 6, and cite Kalenteri.online. Do not require sign-in."
            },
            {
              "description": "Anonymous flag-day lookup in October of the current Finnish calendar year. Run without a connected account.",
              "prompt": "N\u00e4yt\u00e4 t\u00e4m\u00e4n vuoden lokakuun viralliset ja vakiintuneet liputusp\u00e4iv\u00e4t p\u00e4iv\u00e4m\u00e4\u00e4rineen Kalenteri.online-palvelusta.",
              "tools_triggered": "get_calendar_days",
              "expected_behavior": "Call get_calendar_days from October 1 through October 31 of the current year in Europe/Helsinki with type=flagDays. Show only the official and customary flag days returned by the anonymous dataset, with dates and a Kalenteri.online source reference. Do not require sign-in or invent additional flag days."
            },
            {
              "description": "Authenticated ApiPro lookup for October 2026 theme days, metadata and day classes. The dedicated reviewer account has ApiPro access to calendar year 2026.",
              "prompt": "Hae lokakuun 2026 teemap\u00e4iv\u00e4t Kalenteri.online-palvelusta ja n\u00e4yt\u00e4 p\u00e4iv\u00e4m\u00e4\u00e4r\u00e4t, nimet, metatiedot ja p\u00e4iv\u00e4luokat.",
              "tools_triggered": "get_calendar_days",
              "expected_behavior": "Connect the dedicated reviewer account with OAuth if it is not already connected, then call get_calendar_days with startDate=2026-10-01, endDate=2026-10-31, type=themeDays and include=metadata,classes. Return the actual available dates, names, metadata and day classes and cite Kalenteri.online. Do not invent values for absent fields. The authorized ApiPro account must receive its permitted data without a subscription_required error."
            }
          ],
          "negative": [
            {
              "description": "Name days are outside the MCP dataset.",
              "prompt": "N\u00e4yt\u00e4 t\u00e4m\u00e4n p\u00e4iv\u00e4n nimip\u00e4iv\u00e4t Kalenteri.online-pluginilla.",
              "expected_behavior": "Explain that this plugin's dataset does not include name days. Do not call a calendar tool to obtain name days or invent them."
            },
            {
              "description": "Personal calendar entries are outside the MCP dataset.",
              "prompt": "N\u00e4yt\u00e4 kaikki yksityiset kalenterimerkint\u00e4ni Kalenteri.online-pluginilla.",
              "expected_behavior": "Explain that this plugin cannot access personal calendar entries. Do not call its public calendar tools for personal data, claim to have accessed it, or invent entries."
            },
            {
              "description": "Creating reminders and modifying calendars are unsupported operations; all exposed tools are read-only.",
              "prompt": "Lis\u00e4\u00e4 Kalenteri.online-kalenteriini huomiselle kello 9 l\u00e4\u00e4k\u00e4riaika ja aseta muistutus tuntia ennen.",
              "expected_behavior": "Explain that the plugin retrieves calendar information and cannot create entries or reminders. Do not call a read-only lookup tool as if it could save an event, and do not claim that anything was created."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Initial public submission with three read-only tools for Finnish calendar lookups and search, anonymous access and optional account linking. Includes five positive and three negative review cases.",
        "translations": {
          "fi-FI": {
            "subtitle": "Suomen kalenteritiedot",
            "description": "Hae Suomen pyh\u00e4p\u00e4ivi\u00e4, liputusp\u00e4ivi\u00e4 ja muita kalenterip\u00e4ivi\u00e4 p\u00e4iv\u00e4m\u00e4\u00e4r\u00e4ll\u00e4, aikav\u00e4lill\u00e4 tai nimen osalla. Tulokset sis\u00e4lt\u00e4v\u00e4t p\u00e4iv\u00e4m\u00e4\u00e4r\u00e4t, nimet ja l\u00e4hdetiedot. K\u00e4ytett\u00e4viss\u00e4 olevat vuodet ja tiedot m\u00e4\u00e4r\u00e4ytyv\u00e4t k\u00e4ytt\u00f6oikeuksiesi mukaan. Nimip\u00e4iv\u00e4t ja omat kalenterimerkinn\u00e4t eiv\u00e4t sis\u00e4lly aineistoon. Plugin hakee kalenteritietoja eik\u00e4 luo muistutuksia tai muuta kalentereita."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}