.codex-plugin/plugin.json

{
  "name": "citation-generator",
  "version": "1.0.0",
  "description": "APA, MLA and Chicago citations from a DOI or ISBN",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://citation-generator.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "citation generator",
    "apa citation generator",
    "cite this for me",
    "mla citation generator",
    "chicago citation generator",
    "doi to citation",
    "isbn to citation",
    "works cited generator",
    "reference generator apa",
    "bibtex from doi",
    "citation machine",
    "cite my sources"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Zovo Citation Generator",
    "shortDescription": "DOIs and ISBNs to APA & MLA",
    "longDescription": "Turn a DOI or an ISBN into a correctly formatted citation for a student paper or a research reading list, using live registered DOI and ISBN metadata.\n\nType a DOI (10.1038/nphys1170), a doi.org link, or an ISBN-10/ISBN-13, and Zovo Citation Generator looks the record up live: authors, title, year, journal or book, volume, issue, pages and publisher come from the registration. See the citation in APA 7, MLA 9, Chicago author-date and Chicago notes-bibliography, with the author rules for 1, 2, 3 and up to 21 or more authors, sentence case for APA titles and title case for MLA and Chicago, and italics kept in the HTML preview.\n\nA source with no DOI or ISBN goes through the manual tool: type the type, authors, title, year, container, volume, issue, pages, publisher, URL and access date, and it is formatted the same way.\n\nThe result is a works cited or reference list, sorted the way the style requires (by first author family name, then year; a source with no author sorts by title). One DOI or ISBN is one citation card, and a list of up to 25 is formatted in one call. Download the list as BibTeX for your reference manager, RIS for reference software, or a plain text reference list, and copy any single citation from the widget.\n\nWhen a record is missing a year, an author, a journal or a publisher, the citation follows the style rule (APA shows n.d. for no year) and a warning names the missing field. Legal, patent and dataset records get a generic format with a warning.\n\nIt reads the registered value and names the source and the retrieval time. Check your citations before you submit academic work.",
    "developerName": "Zovo",
    "category": "Education & Research",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://citation-generator.zovo.one",
    "supportURL": "https://citation-generator.zovo.one/support",
    "privacyPolicyURL": "https://citation-generator.zovo.one/privacy",
    "termsOfServiceURL": "https://citation-generator.zovo.one/terms",
    "defaultPrompt": [
      "Turn 10.1038/nphys1170 into an APA 7 citation",
      "Cite ISBN 9780140328721 in MLA 9 and Chicago author-date",
      "Make a BibTeX file for these DOIs: 10.1038/nphys1170 and 10.1103/PhysRevLett.116.061102"
    ],
    "brandColor": "#1F6F5C",
    "brandColorDark": "#63C3A8",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/citation-generator/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "DOI to an APA 7 citation",
              "prompt": "Turn 10.1038/nphys1170 into an APA 7 citation",
              "tools_triggered": "generate_citations",
              "expected_behavior": "Calls generate_citations with identifiers=[\"10.1038/nphys1170\"] and style=apa7. Returns the registered 2009 journal article with author, title, journal, volume, issue, pages, DOI and BibTeX, RIS and text download links."
            },
            {
              "description": "ISBN to an MLA 9 citation",
              "prompt": "Cite ISBN 9780140328721 in MLA 9",
              "tools_triggered": "generate_citations",
              "expected_behavior": "Calls generate_citations with identifiers=[\"9780140328721\"] and style=mla9. The registered book record is formatted with the author, title, publisher and year; the item status is ok."
            },
            {
              "description": "A works cited list for two sources in Chicago author-date",
              "prompt": "Make a works cited list for 10.1038/nphys1170 and 9780140328721 in Chicago author-date",
              "tools_triggered": "generate_citations",
              "expected_behavior": "Calls generate_citations with both identifiers and style=chicago_ad. Two citation cards are returned (2 resolved), sorted by first author family name, and a BibTeX, RIS and text download link is offered for the whole list."
            },
            {
              "description": "A manual book entry without a DOI or ISBN",
              "prompt": "Format this APA 7 book reference: Field notes: A study of local habitats, by Avery Morgan, Example Press, 2024.",
              "tools_triggered": "format_manual_citation",
              "expected_behavior": "Calls format_manual_citation with record.type=book, author Avery Morgan, the supplied title, year 2024 and publisher Example Press. The citation reads 'Morgan, A. (2024). Field notes: A study of local habitats. Example Press.'"
            },
            {
              "description": "A doi.org link to a Chicago notes-bibliography citation",
              "prompt": "Cite https://doi.org/10.1038/nphys1170 in Chicago notes-bibliography",
              "tools_triggered": "generate_citations",
              "expected_behavior": "Calls generate_citations with the DOI link and style=chicago_nb. The link is normalised to DOI 10.1038/nphys1170, the item status is ok, and the citation includes the registered journal and 2009 year."
            }
          ],
          "negative": [
            {
              "description": "Reading a source the user uploads is out of scope. Expected: the tool is not called; the assistant says it looks up a DOI or an ISBN and does not read the file.",
              "prompt": "Read this PDF of my assignment and cite every source in it"
            },
            {
              "description": "Finding a DOI for a title is out of scope (the plugin resolves identifiers, it does not search). Expected: the tool is not called with a made-up DOI; the assistant asks for the DOI or the ISBN.",
              "prompt": "Find the DOI for the 1993 Kernis self-esteem paper"
            },
            {
              "description": "Writing academic work is out of scope. Expected: the tool formats citations only; the assistant does not write the essay.",
              "prompt": "Write my literature review and add citations for me"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://citation-generator.zovo.one/widget-preview"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: live DOI and ISBN metadata lookups, APA 7, MLA 9, Chicago author-date and Chicago notes-bibliography formatting, a manual entry for sources without a DOI or ISBN, warnings for missing fields, and BibTeX, RIS and text reference-list downloads.",
        "translations": {
          "pl-PL": {
            "subtitle": "DOI i ISBN do APA oraz MLA",
            "description": "Zamie\u0144 DOI lub ISBN na poprawnie sformatowany przypis do pracy studenckiej albo listy lektur, korzystaj\u0105c z zarejestrowanych metadanych DOI i ISBN pobieranych na \u017cywo.\n\nPodaj DOI (10.1038/nphys1170), link doi.org albo ISBN-10/ISBN-13, a narz\u0119dzie pobierze rekord na \u017cywo: autorzy, tytu\u0142, rok, czasopismo lub ksi\u0105\u017cka, tom, numer, strony i wydawca pochodz\u0105 z rejestracji. Otrzymasz cytowanie w APA 7, MLA 9, Chicago (author-date) i Chicago (notes-bibliography), z regu\u0142ami dla 1, 2, 3 oraz 21 lub wi\u0119cej autor\u00f3w.\n\n\u0179r\u00f3d\u0142o bez DOI i ISBN wpisz w narz\u0119dziu r\u0119cznym. Wynik to lista \u017ar\u00f3de\u0142 posortowana zgodnie ze stylem. Pobierz list\u0119 jako BibTeX, RIS albo zwyk\u0142y plik tekstowy i skopiuj dowolne cytowanie z wid\u017cetu. Gdy brakuje roku, autora, czasopisma lub wydawcy, cytowanie stosuje regu\u0142\u0119 stylu, a ostrze\u017cenie podaje brakuj\u0105ce pole. Sprawd\u017a cytowania przed oddaniem pracy."
          },
          "de-DE": {
            "subtitle": "DOI und ISBN zu APA & MLA",
            "description": "Verwandeln Sie einen DOI oder eine ISBN in ein korrekt formatiertes Zitat f\u00fcr eine Hausarbeit oder eine Literaturliste \u2013 mit den live abgerufenen registrierten DOI- und ISBN-Metadaten.\n\nGeben Sie einen DOI (10.1038/nphys1170), einen doi.org-Link oder eine ISBN-10/ISBN-13 ein; das Werkzeug ruft den Datensatz live ab: Autorinnen und Autoren, Titel, Jahr, Zeitschrift oder Buch, Band, Heft, Seiten und Verlag stammen aus der Registrierung. Sie erhalten das Zitat in APA 7, MLA 9, Chicago (Author-Date) und Chicago (Notes-Bibliography), mit den Regeln f\u00fcr 1, 2, 3 und bis zu 21 oder mehr Autoren.\n\nEine Quelle ohne DOI oder ISBN erfassen Sie im manuellen Werkzeug. Das Ergebnis ist eine nach dem Stil sortierte Quellenliste. Laden Sie die Liste als BibTeX, RIS oder Textdatei herunter und kopieren Sie einzelne Zitate aus dem Widget. Fehlen Jahr, Autor, Zeitschrift oder Verlag, folgt das Zitat der Stilregel und eine Warnung nennt das fehlende Feld. Pr\u00fcfen Sie die Zitate vor der Abgabe."
          },
          "es-ES": {
            "subtitle": "DOI e ISBN a APA y MLA",
            "description": "Convierte un DOI o un ISBN en una cita bien formateada para un trabajo de estudiante o una lista de lecturas, usando los metadatos registrados de DOI e ISBN consultados en vivo.\n\nEscribe un DOI (10.1038/nphys1170), un enlace de doi.org o un ISBN-10/ISBN-13, y la herramienta consulta el registro en vivo: autores, t\u00edtulo, a\u00f1o, revista o libro, volumen, n\u00famero, p\u00e1ginas y editorial proceden del registro. Obtienes la cita en APA 7, MLA 9, Chicago (autor-fecha) y Chicago (notas-bibliograf\u00eda), con las reglas para 1, 2, 3 y hasta 21 o m\u00e1s autores.\n\nUna fuente sin DOI ni ISBN se introduce en la herramienta manual. El resultado es una lista de referencias ordenada seg\u00fan el estilo. Descarga la lista en BibTeX, RIS o texto plano y copia cualquier cita desde el widget. Si falta el a\u00f1o, el autor, la revista o la editorial, la cita sigue la regla del estilo y un aviso indica el campo que falta. Revisa las citas antes de entregar el trabajo."
          },
          "fr-FR": {
            "subtitle": "DOI et ISBN vers APA et MLA",
            "description": "Transformez un DOI ou un ISBN en une citation correctement format\u00e9e pour un devoir ou une bibliographie, \u00e0 partir des m\u00e9tadonn\u00e9es DOI et ISBN enregistr\u00e9es, consult\u00e9es en direct.\n\nSaisissez un DOI (10.1038/nphys1170), un lien doi.org ou un ISBN-10/ISBN-13 : l'outil consulte l'enregistrement en direct. Auteurs, titre, ann\u00e9e, revue ou livre, volume, num\u00e9ro, pages et \u00e9diteur proviennent de l'enregistrement. Vous obtenez la citation en APA 7, MLA 9, Chicago (auteur-date) et Chicago (notes-bibliographie), avec les r\u00e8gles pour 1, 2, 3 et jusqu'\u00e0 21 auteurs ou plus.\n\nUne source sans DOI ni ISBN passe par l'outil manuel. Le r\u00e9sultat est une liste de r\u00e9f\u00e9rences tri\u00e9e selon le style. T\u00e9l\u00e9chargez la liste en BibTeX, RIS ou texte brut et copiez une citation depuis le widget. Si l'ann\u00e9e, l'auteur, la revue ou l'\u00e9diteur manque, la citation suit la r\u00e8gle du style et un avertissement nomme le champ manquant. V\u00e9rifiez les citations avant de rendre votre travail."
          },
          "ja-JP": {
            "subtitle": "DOI\u30fbISBN\u3092APA\u30fbMLA\u3078",
            "description": "\u30ea\u30a2\u30eb\u30bf\u30a4\u30e0\u3067\u53d6\u5f97\u3057\u305f DOI \u3068 ISBN \u306e\u767b\u9332\u30e1\u30bf\u30c7\u30fc\u30bf\u3092\u4f7f\u3063\u3066\u3001DOI \u3084 ISBN \u3092\u5b66\u751f\u306e\u30ec\u30dd\u30fc\u30c8\u3084\u53c2\u8003\u6587\u732e\u30ea\u30b9\u30c8\u7528\u306e\u6b63\u3057\u3044\u5f15\u7528\u306b\u5909\u63db\u3057\u307e\u3059\u3002\n\nDOI\uff0810.1038/nphys1170\uff09\u3001doi.org \u306e\u30ea\u30f3\u30af\u3001ISBN-10/ISBN-13 \u3092\u5165\u529b\u3059\u308b\u3068\u3001\u8a18\u9332\u3092\u30ea\u30a2\u30eb\u30bf\u30a4\u30e0\u3067\u53d6\u5f97\u3057\u307e\u3059\u3002\u8457\u8005\u3001\u30bf\u30a4\u30c8\u30eb\u3001\u5e74\u3001\u96d1\u8a8c\u540d\u307e\u305f\u306f\u66f8\u540d\u3001\u5dfb\u3001\u53f7\u3001\u30da\u30fc\u30b8\u3001\u51fa\u7248\u793e\u306f\u767b\u9332\u5024\u3067\u3059\u3002APA 7\u3001MLA 9\u3001Chicago\uff08\u8457\u8005\u65e5\u4ed8\uff09\u3001Chicago\uff08\u6ce8\u91c8\u30fb\u53c2\u8003\u6587\u732e\uff09\u306e\u5f15\u7528\u3092\u3001\u8457\u80051\u540d\u30fb2\u540d\u30fb3\u540d\u30fb21\u540d\u4ee5\u4e0a\u306e\u898f\u5247\u306b\u5f93\u3063\u3066\u51fa\u529b\u3057\u307e\u3059\u3002\n\nDOI \u3082 ISBN \u3082\u306a\u3044\u8cc7\u6599\u306f\u624b\u52d5\u30c4\u30fc\u30eb\u3067\u5165\u529b\u3057\u307e\u3059\u3002\u7d50\u679c\u306f\u30b9\u30bf\u30a4\u30eb\u306b\u5f93\u3063\u3066\u4e26\u3079\u305f\u53c2\u8003\u6587\u732e\u30ea\u30b9\u30c8\u3067\u3059\u3002BibTeX\u3001RIS\u3001\u30c6\u30ad\u30b9\u30c8\u3067\u30c0\u30a6\u30f3\u30ed\u30fc\u30c9\u3067\u304d\u3001\u30a6\u30a3\u30b8\u30a7\u30c3\u30c8\u304b\u3089\u5f15\u7528\u3092\u30b3\u30d4\u30fc\u3067\u304d\u307e\u3059\u3002\u5e74\u3001\u8457\u8005\u3001\u96d1\u8a8c\u540d\u3001\u51fa\u7248\u793e\u304c\u306a\u3044\u5834\u5408\u306f\u30b9\u30bf\u30a4\u30eb\u306e\u898f\u5247\u306b\u5f93\u3044\u3001\u4e0d\u8db3\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u77e5\u3089\u305b\u307e\u3059\u3002\u63d0\u51fa\u524d\u306b\u5f15\u7528\u3092\u78ba\u8a8d\u3057\u3066\u304f\u3060\u3055\u3044\u3002"
          },
          "pt-BR": {
            "subtitle": "DOI e ISBN para APA e MLA",
            "description": "Transforme um DOI ou um ISBN em uma cita\u00e7\u00e3o bem formatada para um trabalho de estudante ou uma lista de leituras, usando os metadados registrados de DOI e ISBN consultados ao vivo.\n\nDigite um DOI (10.1038/nphys1170), um link doi.org ou um ISBN-10/ISBN-13, e a ferramenta consulta o registro ao vivo: autores, t\u00edtulo, ano, peri\u00f3dico ou livro, volume, n\u00famero, p\u00e1ginas e editora v\u00eam do registro. Voc\u00ea recebe a cita\u00e7\u00e3o em APA 7, MLA 9, Chicago (autor-data) e Chicago (notas-bibliografia), com as regras para 1, 2, 3 e at\u00e9 21 ou mais autores.\n\nUma fonte sem DOI ou ISBN entra pela ferramenta manual. O resultado \u00e9 uma lista de refer\u00eancias ordenada conforme o estilo. Baixe a lista em BibTeX, RIS ou texto simples e copie qualquer cita\u00e7\u00e3o pelo widget. Quando falta ano, autor, peri\u00f3dico ou editora, a cita\u00e7\u00e3o segue a regra do estilo e um aviso indica o campo ausente. Confira as cita\u00e7\u00f5es antes de entregar o trabalho."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}