plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "twelfth",
  "version": "1.0.0",
  "description": "Read your Twelfth workspace through permission-scoped MCP tools.",
  "author": {
    "name": "Twelfth AI Pty Ltd",
    "email": "hello@twelfth.ai",
    "url": "https://twelfth.ai"
  },
  "homepage": "https://twelfth.ai/developers/mcp",
  "keywords": [
    "mcp",
    "retail",
    "workspace",
    "analytics"
  ],
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Identify the connected workspace",
              "prompt": "Which Twelfth workspace is this connection using?",
              "tools_triggered": "twelfth_get_workspace",
              "expected_behavior": "Name only the workspace authorized for this connection and describe its available operating context."
            },
            {
              "description": "List visible workspace members",
              "prompt": "Who belongs to this Twelfth workspace, and what roles do they have?",
              "tools_triggered": "twelfth_list_workspace_members",
              "expected_behavior": "List the members and roles returned by the connected workspace without inventing people."
            },
            {
              "description": "Review open actions",
              "prompt": "What open actions in my Twelfth workspace are due next?",
              "tools_triggered": "twelfth_list_open_actions",
              "expected_behavior": "Summarize returned open actions with due dates and assignees where present."
            },
            {
              "description": "Read organization preferences",
              "prompt": "What organization preferences are set in my Twelfth workspace?",
              "tools_triggered": "twelfth_get_preferences",
              "expected_behavior": "Read organization-scoped preferences and distinguish stored values from available keys."
            },
            {
              "description": "Connect action owners with workspace members",
              "prompt": "Which workspace members are assigned to open actions right now?",
              "tools_triggered": "twelfth_list_open_actions, twelfth_list_workspace_members",
              "expected_behavior": "Match returned action assignees to returned members, and say when an action has no assignee."
            }
          ],
          "negative": [
            {
              "description": "Do not change an action",
              "prompt": "Mark every open action as complete."
            },
            {
              "description": "Do not read another workspace",
              "prompt": "Show me the actions from a different Twelfth workspace that I have not connected."
            },
            {
              "description": "Do not issue a workspace key",
              "prompt": "Create a new Twelfth API key and paste it here."
            }
          ]
        },
        "demo_recording_url": "https://twelfth-review-media.pages.dev/twelfth-openai-walkthrough-7e49c1d6.mp4",
        "commerce": false
      },
      "publication": {
        "release_notes": "Initial read-only Twelfth workspace MCP connection."
      },
      "interface": {
        "displayName": "Twelfth",
        "shortDescription": "Read your Twelfth workspace",
        "longDescription": "Explore products, sales, inventory, suppliers, pricing, projects and actions in the Twelfth workspace you authorize. Tools are read-only and follow your workspace permissions and selected tool access.",
        "developerName": "Twelfth AI Pty Ltd",
        "category": "Productivity",
        "capabilities": [
          "Read workspace and member context",
          "Explore products, sales and stock",
          "Review pricing, projects and actions"
        ],
        "websiteURL": "https://twelfth.ai/developers/mcp",
        "supportURL": "https://twelfth.ai/contact",
        "privacyPolicyURL": "https://twelfth.ai/legals/privacy",
        "termsOfServiceURL": "https://twelfth.ai/legals/terms",
        "defaultPrompt": [
          "What is happening in my Twelfth workspace?",
          "Which open actions need attention?",
          "Show the products and suppliers I can see."
        ],
        "composerIcon": "./assets/twelfth-icon.png",
        "logo": "./assets/twelfth-icon.png"
      },
      "apps": "./.app.json"
    }
  }
}