plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "parrot-spanish",
  "version": "1.0.3",
  "description": "Bring your Parrot Spanish level, streak, and vocabulary into ChatGPT, and save words you learn back to Parrot.",
  "author": {
    "name": "Parrot Learning US Inc.",
    "email": "support@parrotapp.com",
    "url": "https://www.parrotapp.com"
  },
  "homepage": "https://www.parrotapp.com/ai-connector",
  "keywords": [
    "spanish",
    "language learning",
    "vocabulary",
    "education"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Parrot",
        "shortDescription": "Practice Spanish at your level",
        "longDescription": "Bring your Parrot Spanish level, streak, and vocabulary into ChatGPT, and save words you learn back to Parrot.\n\nParrot is a Spanish learning app. Once you connect your Parrot account, ChatGPT can see your Parrot level and the matching CEFR level, your day streak, and the Spanish words you are learning and already know. It uses them to pitch explanations, conversations, and quizzes at your level and around your own words.\n\nWhen you ask, ChatGPT can save new Spanish words to your Parrot dictionary as learning or known, and count a real practice session toward your Parrot streak.\n\nWho it's for: Parrot learners who want to practice Spanish in ChatGPT with the same level and vocabulary they use in the app.\n\nLimitations: requires a Parrot account. Spanish only. ChatGPT cannot change your Parrot level, and it never sees your email, password, payment details, or listening history. You can disconnect at any time in Parrot under Settings, Connected Apps.",
        "developerName": "Parrot Learning US Inc.",
        "category": "Education & Research",
        "capabilities": [
          "Read Spanish level and streak",
          "List learning and known words",
          "Save words to Parrot",
          "Record daily practice"
        ],
        "websiteURL": "https://www.parrotapp.com/ai-connector",
        "supportURL": "https://www.parrotapp.com/ai-connector#support",
        "privacyPolicyURL": "https://www.parrotapp.com/privacy#connected-apps",
        "termsOfServiceURL": "https://www.parrotapp.com/terms",
        "defaultPrompt": [
          "What's my Spanish level in Parrot?",
          "Quiz me on the words I'm learning in Parrot.",
          "Teach me five travel words at my level and save them to Parrot."
        ],
        "brandColor": "#2D72C8",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Read the learner's level, streak, and word counts",
              "prompt": "What's my Spanish level in Parrot?",
              "tools_triggered": "get_learner_context",
              "expected_behavior": "States the learner's CEFR level from Parrot (Lower A2 on the test account), their day streak, and how many words they know and are learning. Does not claim to change the level."
            },
            {
              "description": "Quiz the learner on words they are learning",
              "prompt": "Quiz me on the words I'm learning in Parrot.",
              "tools_triggered": "get_learner_context, list_learning_words",
              "expected_behavior": "Fetches the learner's learning words (for example perro, gato, casa, biblioteca, viajar, cocinar on the test account) and runs a short quiz using those words at an A2 level."
            },
            {
              "description": "List words the learner already knows",
              "prompt": "Which Spanish words do I already know in Parrot?",
              "tools_triggered": "list_known_words",
              "expected_behavior": "Lists the learner's known words with English meanings (for example hola, gracias, agua, bueno, amigo on the test account)."
            },
            {
              "description": "Save a new word to Parrot when the learner asks",
              "prompt": "Save \"ventana\" (window) to Parrot as a word I'm learning.",
              "tools_triggered": "set_word_status",
              "expected_behavior": "Saves ventana with the meaning window as a learning word and confirms which word was saved and its status. Does not say the level changed."
            },
            {
              "description": "Count a practice session toward the streak",
              "prompt": "I just finished practicing Spanish with you. Count it toward my Parrot streak.",
              "tools_triggered": "record_practice_today",
              "expected_behavior": "Records today's practice and reports the day streak. If today was already counted, says so instead of claiming a new increase."
            }
          ],
          "negative": [
            {
              "description": "Changing the level is not supported; it should explain that the Parrot level can't be changed from ChatGPT and not call any write tool.",
              "prompt": "Change my Parrot level to C1."
            },
            {
              "description": "Billing is out of scope; it should say it can't see Parrot subscription or payment details and point the user to the Parrot app.",
              "prompt": "What payment method is on my Parrot subscription?"
            },
            {
              "description": "Deleting data is not supported; it should say it can't delete words or the account and not call set_word_status.",
              "prompt": "Delete all my words from Parrot."
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=U60UG4SPnoM",
        "commerce": false,
        "commerce_description": "Parrot's connector does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Initial release: read Spanish level, streak, and vocabulary from Parrot; save words and record practice back to Parrot."
      },
      "apps": "./.app.json"
    }
  }
}