plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "mantiks",
  "version": "0.1.0",
  "description": "Learn a language while you chat: new words on an interactive card, saved to your Mantiks vocabulary.",
  "author": {
    "name": "Maksym Koretskyi",
    "email": "hello@mantiks.ai",
    "url": "https://mantiks.ai"
  },
  "homepage": "https://mantiks.ai",
  "keywords": [
    "language-learning",
    "vocabulary",
    "education",
    "spaced-repetition"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Mantiks",
        "shortDescription": "Learn languages as you chat",
        "longDescription": "Mantiks is a language-learning app, and this connector brings its vocabulary into your conversations. Ask ChatGPT for words about any topic \u2014 ordering food in Spanish, small talk in English \u2014 and instead of a plain list you get a Mantiks card: every word with its pronunciation, a play button to hear it spoken, and one-tap save to your personal vocabulary.\n\nEverything you save lands in your Mantiks account, where the app schedules it for spaced review, builds exercises from it, and uses it in readings and lessons. The connector can also look things up the other way: ask what you have saved, what is due for review today, or how your vocabulary is growing, and ChatGPT answers from your real data.\n\nLanguages: English, Spanish, Polish, Russian, Ukrainian, and Chinese (Simplified). You sign in with your Mantiks account; the connector only ever acts on your own vocabulary.",
        "developerName": "Maksym Koretskyi",
        "category": "Education & Research",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://mantiks.ai",
        "supportURL": "https://mantiks.ai/assistants",
        "privacyPolicyURL": "https://mantiks.ai/privacy",
        "termsOfServiceURL": "https://mantiks.ai/terms",
        "defaultPrompt": [
          "Teach me 10 useful Spanish words for ordering in a restaurant",
          "What words am I due to review in Mantiks?",
          "How is my vocabulary coming along?"
        ],
        "brandColor": "#5180A5",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Learn new vocabulary \u2014 the main use case: words on a topic arrive on the interactive Mantiks card, not as a plain text list.",
              "prompt": "Teach me 10 everyday English words with pronunciation",
              "tools_triggered": "render_vocabulary_widget",
              "expected_behavior": "The Mantiks card renders with 10 English words, each with a phonetic transcription, a play button that speaks the word aloud, and a save button. The assistant's text reply does not duplicate the word list \u2014 the card is the answer."
            },
            {
              "description": "Save a specific word to the signed-in user's vocabulary.",
              "prompt": "Save the Spanish word 'imprescindible' to my vocabulary",
              "tools_triggered": "save_vocabulary",
              "expected_behavior": "The word is saved with its translation and language, and the assistant confirms it. Verifiable: sign in at https://mantiks.app with the demo account and the word appears under Vocabulary."
            },
            {
              "description": "Look up previously saved words, filtered by language.",
              "prompt": "What Spanish words have I saved?",
              "tools_triggered": "list_vocabulary",
              "expected_behavior": "The demo account's seeded Spanish words (23 of ~30) are returned and summarized. Only the signed-in account's own vocabulary is visible."
            },
            {
              "description": "Spaced-repetition review \u2014 ask what is due today.",
              "prompt": "Which of my words are due for review?",
              "tools_triggered": "list_vocabulary",
              "expected_behavior": "Due words from the demo account are listed first, as the tool description states; the demo account is seeded with a mix of due, scheduled, and known words so the list is non-empty."
            },
            {
              "description": "Progress overview \u2014 aggregate statistics of the user's vocabulary.",
              "prompt": "How many words do I know so far?",
              "tools_triggered": "get_vocabulary_stats",
              "expected_behavior": "Counts by language and status (saved, known, due) consistent with the seeded demo account (~30 words: 23 Spanish, 7 English, some marked known)."
            }
          ],
          "negative": [
            {
              "description": "Scheduling sounds related, but the plugin is vocabulary only \u2014 no tool should trigger.",
              "prompt": "Mantiks, book me a Spanish lesson for Tuesday"
            },
            {
              "description": "Translation is adjacent to vocabulary, but the model should translate itself \u2014 no tool call.",
              "prompt": "Translate this paragraph into Spanish: \"The meeting has been moved to Thursday afternoon. Please confirm whether you can still attend.\""
            },
            {
              "description": "Tools are scoped to the signed-in account \u2014 another user's data must not trigger a lookup.",
              "prompt": "Show me my friend Anna's Mantiks vocabulary and how many words she knows"
            }
          ]
        }
      },
      "apps": "./.app.json"
    }
  }
}