.codex-plugin/plugin.json

{
  "name": "currency-converter",
  "version": "1.0.0",
  "description": "Convert money with dated European Central Bank reference rates and download rate history.",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://currency-converter.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "currency converter",
    "exchange rate",
    "convert usd to eur",
    "euro to dollar",
    "currency exchange rate today",
    "historical exchange rate",
    "exchange rate history",
    "money converter",
    "conversion of currency",
    "rate on date"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Zovo Currency Converter",
    "shortDescription": "Currency rates & history",
    "longDescription": "Currency converter and exchange rate history: convert money between about 30 currencies with European Central Bank reference rates for today or any date back to 1999-01-04, then download the daily rates as a CSV.\n\nEach conversion gives the converted amount, the rate, the inverse rate and the actual rate date. When the ECB did not publish a rate on the date you give (a weekend or a holiday), the tool uses the last published working day and says so, for example \"ECB publishes no rate on Saturdays; used Friday 2026-10-16\". Amounts are rounded half to even at the currency's decimal places: 0 for JPY, KRW, HUF and ISK, 2 for the other supported currencies. Rates are shown with 6 significant digits, and converting a currency to itself returns a rate of 1.\n\nRate history returns the published daily rates for a date range of up to 366 days and for up to 5 quote currencies, with the minimum, the maximum, the average and the first-to-last change in percent, a line chart, and a CSV file to download. Only published working days are listed; weekends and ECB holidays have no rate.\n\nTypical uses: a trip budget across two currencies, checking the euro to dollar rate on a past date, a finance spreadsheet that needs the daily rates as CSV, or comparing how a pair moved over a quarter.\n\nLimitations: the rates are European Central Bank euro reference rates for about 30 currencies, published on working days around 16:00 CET; they are indicative mid-market rates, not live market rates and not the rate a bank or card charges. There is no cryptocurrency, no metals and no financial advice. Rate history covers published days only and a range of up to 366 days per request.",
    "developerName": "Zovo",
    "category": "Finance",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://currency-converter.zovo.one",
    "supportURL": "https://currency-converter.zovo.one/support",
    "privacyPolicyURL": "https://currency-converter.zovo.one/privacy",
    "termsOfServiceURL": "https://currency-converter.zovo.one/terms",
    "defaultPrompt": [
      "Convert 250 USD to EUR at the latest ECB reference rate",
      "What was the euro to dollar exchange rate on 2026-01-02?",
      "Show the USD to EUR exchange rate history from 2026-09-01 to 2026-09-30 and give me a CSV"
    ],
    "brandColor": "#1F7A5A",
    "brandColorDark": "#5CC79B",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/currency-converter/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Dated conversion with rate and inverse rate",
              "prompt": "Convert 250 USD to EUR at the ECB reference rate for 2026-10-16",
              "tools_triggered": "convert_currency",
              "expected_behavior": "Calls convert_currency with amount=250, from=USD, to=EUR, date=2026-10-16. The reply and widget show 250.00 USD = 222.16 EUR, rate 0.88865, 1 EUR = 1.1253 USD, and rate date 2026-10-16. The source line names the European Central Bank reference rates through the Frankfurter API."
            },
            {
              "description": "Two target currencies in one call",
              "prompt": "Convert 1000 USD to EUR and JPY using the 2026-10-16 rate",
              "tools_triggered": "convert_currency",
              "expected_behavior": "Calls convert_currency with amount=1000, from=USD, to=EUR,JPY, date=2026-10-16. The reply and widget show 1000.00 USD = 888.65 EUR and 1000.00 USD = 158020 JPY, with rates 0.88865 and 158.02, and the inverse rate 0.00632831 for JPY."
            },
            {
              "description": "Rate history for one quote currency",
              "prompt": "Show the USD to EUR exchange rate history from 2026-09-01 to 2026-09-30",
              "tools_triggered": "rate_history",
              "expected_behavior": "Calls rate_history with base=USD, quote=EUR, start=2026-09-01, end=2026-09-30. The reply and widget show 22 published days, min 0.85822, max 0.88067, average 0.86863 and a first-to-last change of 2.07%, with a line chart and a CSV download link."
            },
            {
              "description": "Rate history for two quote currencies",
              "prompt": "Show the USD to EUR and JPY rate history from 2026-08-01 to 2026-10-16",
              "tools_triggered": "rate_history",
              "expected_behavior": "Calls rate_history with base=USD, quote=EUR,JPY, start=2026-08-01, end=2026-10-16. Each quote has 55 published days from 2026-08-03 to 2026-10-16; EUR min 0.85477, max 0.89469, average 0.871342, change 2.51%; JPY min 153.27, max 160.16, average 157.696, change 0.86%. A CSV download link is included."
            },
            {
              "description": "Weekend date falls back to the last published day",
              "prompt": "What is the USD to EUR exchange rate for Saturday 2026-10-17?",
              "tools_triggered": "convert_currency",
              "expected_behavior": "Calls convert_currency with date=2026-10-17. The ECB publishes no rate on Saturdays, so the result uses Friday 2026-10-16 with rate 0.88865, and the reply and widget state that the requested date is 2026-10-17 and the rate date is 2026-10-16."
            }
          ],
          "negative": [
            {
              "description": "Cryptocurrency prices are out of scope (no crypto). Expected: the tool is not called; the assistant says the plugin covers European Central Bank currency reference rates only, not Bitcoin.",
              "prompt": "What is the live Bitcoin price in US dollars?"
            },
            {
              "description": "Investment advice is out of scope. Expected: the tool is not called; the assistant says it gives reference rates, not financial advice, and does not tell the user to buy or sell.",
              "prompt": "Should I convert my savings to euros now or wait?"
            },
            {
              "description": "Metals are out of scope. Expected: the tool is not called; the assistant says gold and other metals are not covered.",
              "prompt": "Convert 100 US dollars into gold ounces"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://currency-converter.zovo.one/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: convert_currency (dated European Central Bank reference rates for today or any date since 1999-01-04, with rate, inverse rate and the published rate date) and rate_history (published daily rates for a range up to 366 days with min, max, average, change percent, a chart and a CSV download).",
        "translations": {
          "pl-PL": {
            "subtitle": "Kursy walut i historia",
            "description": "Przelicznik walut i historia kurs\u00f3w: przeliczaj pieni\u0105dze mi\u0119dzy oko\u0142o 30 walutami na podstawie referencyjnych kurs\u00f3w Europejskiego Banku Centralnego dla dnia dzisiejszego lub dowolnej daty od 1999-01-04, a nast\u0119pnie pobierz dzienne kursy w pliku CSV.\n\nKa\u017cde przeliczenie podaje przeliczon\u0105 kwot\u0119, kurs, kurs odwrotny oraz faktyczn\u0105 dat\u0119 kursu. Je\u015bli EBC nie opublikowa\u0142 kursu w podanej dacie (weekend lub \u015bwi\u0119to), narz\u0119dzie u\u017cyje ostatniego opublikowanego dnia roboczego i wyra\u017anie to zaznaczy. Kwoty s\u0105 zaokr\u0105glane do parzystej liczby miejsc dziesi\u0119tnych waluty: 0 dla JPY, KRW, HUF i ISK, 2 dla pozosta\u0142ych obs\u0142ugiwanych walut. Kursy s\u0105 pokazywane z 6 cyframi znacz\u0105cymi, a przeliczenie waluty na ni\u0105 sam\u0105 daje kurs 1.\n\nHistoria kurs\u00f3w zwraca opublikowane kursy dzienne dla zakresu do 366 dni i do 5 walut, z minimum, maksimum, \u015bredni\u0105 i zmian\u0105 od pierwszego do ostatniego dnia w procentach, wykresem liniowym oraz plikiem CSV do pobrania. Podane s\u0105 tylko opublikowane dni robocze; weekendy i \u015bwi\u0119ta EBC nie maj\u0105 kursu.\n\nOgraniczenia: kursy to referencyjne kursy euro Europejskiego Banku Centralnego dla oko\u0142o 30 walut, publikowane w dni robocze oko\u0142o 16:00 CET; s\u0105 to orientacyjne kursy \u015brednie rynkowe, a nie kursy na \u017cywo ani kursy banku lub karty. Brak kryptowalut, metali i porad finansowych. Historia obejmuje tylko opublikowane dni i zakres do 366 dni na jedno zapytanie."
          },
          "de-DE": {
            "subtitle": "W\u00e4hrungskurse & Verlauf",
            "description": "W\u00e4hrungsumrechner und Wechselkursverlauf: Rechnen Sie Geld zwischen rund 30 W\u00e4hrungen mit den Referenzkursen der Europ\u00e4ischen Zentralbank f\u00fcr heute oder jedes Datum ab 1999-01-04 um und laden Sie die Tageskurse als CSV herunter.\n\nJede Umrechnung zeigt den umgerechneten Betrag, den Kurs, den Kehrwert und das tats\u00e4chliche Kursdatum. Wenn die EZB an dem angegebenen Datum keinen Kurs ver\u00f6ffentlicht hat (Wochenende oder Feiertag), nutzt das Werkzeug den letzten ver\u00f6ffentlichten Arbeitstag und sagt das ausdr\u00fccklich. Betr\u00e4ge werden kaufm\u00e4nnisch auf die Nachkommastellen der W\u00e4hrung gerundet: 0 f\u00fcr JPY, KRW, HUF und ISK, 2 f\u00fcr die \u00fcbrigen unterst\u00fctzten W\u00e4hrungen. Kurse werden mit 6 signifikanten Stellen angezeigt; eine W\u00e4hrung zu sich selbst ergibt den Kurs 1.\n\nDer Kursverlauf liefert die ver\u00f6ffentlichten Tageskurse f\u00fcr einen Zeitraum von bis zu 366 Tagen und bis zu 5 Kursw\u00e4hrungen mit Minimum, Maximum, Durchschnitt und der Ver\u00e4nderung vom ersten zum letzten Tag in Prozent, einem Liniendiagramm und einer CSV-Datei. Es erscheinen nur ver\u00f6ffentlichte Arbeitstage; an Wochenenden und EZB-Feiertagen gibt es keinen Kurs.\n\nEinschr\u00e4nkungen: Die Kurse sind EZB-Euro-Referenzkurse f\u00fcr rund 30 W\u00e4hrungen, ver\u00f6ffentlicht an Arbeitstagen gegen 16:00 CET; es sind indikative Mittelkurse, keine Live-Marktkurse und nicht der Kurs einer Bank oder Karte. Keine Kryptow\u00e4hrungen, keine Metalle und keine Finanzberatung. Der Verlauf umfasst nur ver\u00f6ffentlichte Tage und h\u00f6chstens 366 Tage pro Anfrage."
          },
          "es-ES": {
            "subtitle": "Divisas y su historial",
            "description": "Conversor de divisas e historial de tipos de cambio: convierte dinero entre unas 30 monedas con los tipos de referencia del Banco Central Europeo para hoy o cualquier fecha desde el 1999-01-04, y descarga los tipos diarios en CSV.\n\nCada conversi\u00f3n muestra el importe convertido, el tipo, el tipo inverso y la fecha real del tipo. Si el BCE no public\u00f3 un tipo en la fecha indicada (fin de semana o festivo), la herramienta usa el \u00faltimo d\u00eda laborable publicado y lo indica. Los importes se redondean por redondeo bancario a los decimales de la moneda: 0 para JPY, KRW, HUF e ISK, 2 para las dem\u00e1s monedas admitidas. Los tipos se muestran con 6 cifras significativas, y convertir una moneda a s\u00ed misma da un tipo de 1.\n\nEl historial devuelve los tipos diarios publicados para un rango de hasta 366 d\u00edas y hasta 5 monedas, con el m\u00ednimo, el m\u00e1ximo, la media y la variaci\u00f3n del primero al \u00faltimo d\u00eda en porcentaje, un gr\u00e1fico de l\u00edneas y un archivo CSV. Solo aparecen los d\u00edas laborables publicados; los fines de semana y los festivos del BCE no tienen tipo.\n\nLimitaciones: los tipos son tipos de referencia del euro del Banco Central Europeo para unas 30 monedas, publicados en d\u00edas laborables hacia las 16:00 CET; son tipos medios indicativos, no tipos de mercado en vivo ni el tipo de un banco o una tarjeta. No hay criptomonedas, metales ni asesoramiento financiero. El historial solo cubre d\u00edas publicados y un rango de hasta 366 d\u00edas por consulta."
          },
          "fr-FR": {
            "subtitle": "Taux de change et historique",
            "description": "Convertisseur de devises et historique des taux de change : convertissez de l'argent entre une trentaine de devises avec les taux de r\u00e9f\u00e9rence de la Banque centrale europ\u00e9enne pour aujourd'hui ou toute date depuis le 1999-01-04, puis t\u00e9l\u00e9chargez les taux quotidiens en CSV.\n\nChaque conversion indique le montant converti, le taux, le taux inverse et la date r\u00e9elle du taux. Si la BCE n'a pas publi\u00e9 de taux \u00e0 la date demand\u00e9e (week-end ou jour f\u00e9ri\u00e9), l'outil utilise le dernier jour ouvr\u00e9 publi\u00e9 et le pr\u00e9cise. Les montants sont arrondis au pair le plus proche selon les d\u00e9cimales de la devise : 0 pour JPY, KRW, HUF et ISK, 2 pour les autres devises prises en charge. Les taux sont affich\u00e9s avec 6 chiffres significatifs ; convertir une devise en elle-m\u00eame donne un taux de 1.\n\nL'historique renvoie les taux quotidiens publi\u00e9s pour une p\u00e9riode allant jusqu'\u00e0 366 jours et jusqu'\u00e0 5 devises, avec le minimum, le maximum, la moyenne et la variation du premier au dernier jour en pourcentage, un graphique en courbes et un fichier CSV. Seuls les jours ouvr\u00e9s publi\u00e9s apparaissent ; les week-ends et les jours f\u00e9ri\u00e9s de la BCE n'ont pas de taux.\n\nLimites : les taux sont des taux de r\u00e9f\u00e9rence de l'euro de la Banque centrale europ\u00e9enne pour une trentaine de devises, publi\u00e9s les jours ouvr\u00e9s vers 16:00 CET ; ce sont des taux moyens indicatifs, pas des taux de march\u00e9 en direct ni le taux d'une banque ou d'une carte. Pas de cryptomonnaies, pas de m\u00e9taux, pas de conseil financier. L'historique ne couvre que les jours publi\u00e9s et une p\u00e9riode de 366 jours au maximum par requ\u00eate."
          },
          "ja-JP": {
            "subtitle": "\u70ba\u66ff\u30ec\u30fc\u30c8\u3068\u63a8\u79fb",
            "description": "\u901a\u8ca8\u63db\u7b97\u3068\u70ba\u66ff\u30ec\u30fc\u30c8\u306e\u63a8\u79fb\uff1a\u6b27\u5dde\u4e2d\u592e\u9280\u884c\uff08ECB\uff09\u306e\u53c2\u7167\u30ec\u30fc\u30c8\u3092\u4f7f\u3044\u3001\u7d0430\u306e\u901a\u8ca8\u9593\u3067\u91d1\u984d\u3092\u63db\u7b97\u3057\u307e\u3059\u3002\u4eca\u65e5\u3067\u30821999-01-04\u4ee5\u964d\u306e\u4efb\u610f\u306e\u65e5\u4ed8\u3067\u3082\u6307\u5b9a\u3067\u304d\u3001\u65e5\u6b21\u30ec\u30fc\u30c8\u306fCSV\u3067\u30c0\u30a6\u30f3\u30ed\u30fc\u30c9\u3067\u304d\u307e\u3059\u3002\n\n\u5404\u63db\u7b97\u3067\u306f\u3001\u63db\u7b97\u5f8c\u306e\u91d1\u984d\u3001\u30ec\u30fc\u30c8\u3001\u9006\u6570\u30ec\u30fc\u30c8\u3001\u5b9f\u969b\u306e\u30ec\u30fc\u30c8\u65e5\u4ed8\u3092\u8868\u793a\u3057\u307e\u3059\u3002\u6307\u5b9a\u3057\u305f\u65e5\u306bECB\u304c\u30ec\u30fc\u30c8\u3092\u516c\u8868\u3057\u3066\u3044\u306a\u3044\u5834\u5408\uff08\u9031\u672b\u3084\u795d\u65e5\uff09\u306f\u3001\u76f4\u8fd1\u306b\u516c\u8868\u3055\u308c\u305f\u55b6\u696d\u65e5\u3092\u4f7f\u7528\u3057\u3001\u305d\u306e\u65e8\u3092\u660e\u793a\u3057\u307e\u3059\u3002\u91d1\u984d\u306f\u901a\u8ca8\u306e\u5c0f\u6570\u70b9\u4ee5\u4e0b\u306e\u6841\u6570\u3067\u9280\u884c\u4e38\u3081\uff08\u5076\u6570\u3078\u306e\u4e38\u3081\uff09\u3092\u884c\u3044\u307e\u3059\u3002JPY\u3001KRW\u3001HUF\u3001ISK\u306f0\u6841\u3001\u305d\u306e\u4ed6\u306e\u5bfe\u5fdc\u901a\u8ca8\u306f2\u6841\u3067\u3059\u3002\u30ec\u30fc\u30c8\u306f\u6709\u52b9\u6570\u5b576\u6841\u3067\u8868\u793a\u3057\u3001\u540c\u3058\u901a\u8ca8\u3078\u306e\u63db\u7b97\u306f\u30ec\u30fc\u30c81\u306b\u306a\u308a\u307e\u3059\u3002\n\n\u30ec\u30fc\u30c8\u63a8\u79fb\u306f\u3001\u6700\u5927366\u65e5\u30fb\u6700\u59275\u901a\u8ca8\u306e\u516c\u8868\u6e08\u307f\u65e5\u6b21\u30ec\u30fc\u30c8\u3092\u8fd4\u3057\u3001\u6700\u5c0f\u5024\u3001\u6700\u5927\u5024\u3001\u5e73\u5747\u5024\u3001\u6700\u521d\u304b\u3089\u6700\u5f8c\u3078\u306e\u5909\u5316\u7387\uff08\uff05\uff09\u3001\u6298\u308c\u7dda\u30b0\u30e9\u30d5\u3001CSV\u30d5\u30a1\u30a4\u30eb\u3092\u63d0\u4f9b\u3057\u307e\u3059\u3002\u8868\u793a\u3055\u308c\u308b\u306e\u306f\u516c\u8868\u3055\u308c\u305f\u55b6\u696d\u65e5\u306e\u307f\u3067\u3001\u9031\u672b\u3068ECB\u306e\u795d\u65e5\u306b\u306f\u30ec\u30fc\u30c8\u304c\u3042\u308a\u307e\u305b\u3093\u3002\n\n\u5236\u9650\u4e8b\u9805\uff1a\u30ec\u30fc\u30c8\u306f\u7d0430\u901a\u8ca8\u3092\u5bfe\u8c61\u3068\u3057\u305fECB\u306e\u30e6\u30fc\u30ed\u53c2\u7167\u30ec\u30fc\u30c8\u3067\u3001\u55b6\u696d\u65e5\u306e16:00 CET\u9803\u306b\u516c\u8868\u3055\u308c\u307e\u3059\u3002\u3053\u308c\u306f\u53c2\u8003\u3068\u306a\u308b\u4ef2\u5024\u3067\u3042\u308a\u3001\u30ea\u30a2\u30eb\u30bf\u30a4\u30e0\u306e\u5e02\u5834\u30ec\u30fc\u30c8\u3067\u3082\u3001\u9280\u884c\u3084\u30ab\u30fc\u30c9\u306e\u9069\u7528\u30ec\u30fc\u30c8\u3067\u3082\u3042\u308a\u307e\u305b\u3093\u3002\u6697\u53f7\u8cc7\u7523\u3001\u91d1\u5c5e\u3001\u6295\u8cc7\u52a9\u8a00\u306f\u6271\u3044\u307e\u305b\u3093\u3002\u30ec\u30fc\u30c8\u63a8\u79fb\u306f\u516c\u8868\u65e5\u306e\u307f\u3092\u5bfe\u8c61\u3068\u3057\u30011\u56de\u306e\u30ea\u30af\u30a8\u30b9\u30c8\u3067\u6700\u5927366\u65e5\u3067\u3059\u3002"
          },
          "pt-BR": {
            "subtitle": "Cota\u00e7\u00f5es e hist\u00f3rico",
            "description": "Conversor de moedas e hist\u00f3rico de taxas de c\u00e2mbio: converta dinheiro entre cerca de 30 moedas com as taxas de refer\u00eancia do Banco Central Europeu para hoje ou qualquer data desde 1999-01-04 e baixe as taxas di\u00e1rias em CSV.\n\nCada convers\u00e3o mostra o valor convertido, a taxa, a taxa inversa e a data real da taxa. Se o BCE n\u00e3o publicou uma taxa na data indicada (fim de semana ou feriado), a ferramenta usa o \u00faltimo dia \u00fatil publicado e informa isso. Os valores s\u00e3o arredondados para o par mais pr\u00f3ximo conforme as casas decimais da moeda: 0 para JPY, KRW, HUF e ISK, 2 para as demais moedas aceitas. As taxas aparecem com 6 algarismos significativos, e converter uma moeda nela mesma resulta em taxa 1.\n\nO hist\u00f3rico retorna as taxas di\u00e1rias publicadas para um intervalo de at\u00e9 366 dias e at\u00e9 5 moedas, com m\u00ednimo, m\u00e1ximo, m\u00e9dia e a varia\u00e7\u00e3o do primeiro ao \u00faltimo dia em porcentagem, um gr\u00e1fico de linhas e um arquivo CSV. Aparecem apenas os dias \u00fateis publicados; fins de semana e feriados do BCE n\u00e3o t\u00eam taxa.\n\nLimita\u00e7\u00f5es: as taxas s\u00e3o taxas de refer\u00eancia do euro do Banco Central Europeu para cerca de 30 moedas, publicadas em dias \u00fateis por volta das 16:00 CET; s\u00e3o taxas m\u00e9dias indicativas, n\u00e3o taxas de mercado ao vivo nem a taxa de um banco ou cart\u00e3o. N\u00e3o h\u00e1 criptomoedas, metais nem consultoria financeira. O hist\u00f3rico cobre apenas dias publicados e um intervalo de at\u00e9 366 dias por consulta."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}