plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "claromap",
  "version": "1.0.4",
  "description": "Turn conversations into structured notes and mind maps in your ClaroMap account.",
  "author": {
    "name": "ClaroMap",
    "email": "support@claromap.com",
    "url": "https://claromap.com"
  },
  "homepage": "https://claromap.com",
  "keywords": [
    "notes",
    "mind map",
    "knowledge",
    "study",
    "planning"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "ClaroMap",
        "shortDescription": "Linked notes and mind maps",
        "longDescription": "ClaroMap turns scattered ideas into a clear structure. With this plugin, ChatGPT can create a topic in your ClaroMap account with notes arranged in a parent-child hierarchy, read your existing topics and notes, add notes to a topic, connect notes, and edit a note when you ask. You sign in with your own ClaroMap account and ChatGPT only reaches your content after you approve access. Everything it writes appears in ClaroMap straight away, where you can keep editing as notes or a mind map.",
        "developerName": "ClaroMap",
        "category": "Productivity",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://claromap.com",
        "supportURL": "https://claromap.com/support",
        "privacyPolicyURL": "https://claromap.com/privacy",
        "termsOfServiceURL": "https://claromap.com/terms",
        "defaultPrompt": [
          "Turn this conversation into a ClaroMap topic with notes",
          "What topics do I have in ClaroMap?",
          "Add what we just discussed to my launch plan topic in ClaroMap"
        ],
        "brandColor": "#4731F5",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "screenshots": []
      },
      "review": {
        "demo_recording_url": "https://drive.google.com/file/d/1fOZYk-zqAr4uNghJJHB87-_aeyewQyXj/view?usp=sharing",
        "test_cases": {
          "positive": [
            {
              "description": "Create a topic with a note hierarchy",
              "prompt": "Create a ClaroMap topic called Product launch with notes Positioning, Pricing, Launch channels and Success metrics under a main Product launch note.",
              "tools_triggered": "create_topic",
              "expected_behavior": "A new topic with five notes in a parent-child tree appears in the ClaroMap app."
            },
            {
              "description": "List topics and read one. Setup: use the Product launch topic created by the first test case in the dedicated reviewer account.",
              "prompt": "What topics do I have in ClaroMap, and what is in Product launch?",
              "tools_triggered": "list_topics, get_topic",
              "expected_behavior": "The topic list, then the Product launch notes as an indented hierarchy."
            },
            {
              "description": "Add notes under an existing note and check that reconnecting an existing parent-child pair is idempotent. Setup: use Product launch from the first test case; Risks and Budget must not already exist. Use the existing topic and note ids returned by the tools.",
              "prompt": "In my Product launch topic add Risks and Budget under Launch channels. Then connect Launch channels as the parent of Budget again; keep the existing Budget note and do not add a duplicate link.",
              "tools_triggered": "get_topic, add_notes, connect_notes",
              "expected_behavior": "Exactly two new notes, Risks and Budget, appear under Launch channels. Calling connect_notes with Launch channels as parent and the existing Budget note as child reports they are already connected and adds no duplicate note or edge. Existing notes and their contents are unchanged."
            },
            {
              "description": "Search and read notes. Setup: the dedicated reviewer account contains the Positioning note created by the first test case. Read the matching result with fetch before summarising it.",
              "prompt": "Find my notes about positioning and summarise them.",
              "tools_triggered": "search, fetch",
              "expected_behavior": "A summary drawn from the matching note, with no unrelated content."
            },
            {
              "description": "Edit a note after confirmation. Setup: use Product launch from the first test case, where the Pricing note has not yet been renamed. Approve the requested change when ChatGPT asks for confirmation.",
              "prompt": "In my Product launch topic, rename the Pricing note to Pricing model.",
              "tools_triggered": "get_topic, update_note",
              "expected_behavior": "ChatGPT asks to confirm. After approval, update_note targets the existing Pricing note id and changes only its title to Pricing model. Its id, content and connections stay the same; no second note is created."
            }
          ],
          "negative": [
            {
              "description": "Deleting is not supported. ChatGPT should say the plugin cannot delete anything and call no write tool.",
              "prompt": "Delete my Product launch topic."
            },
            {
              "description": "Accessing another person's private account is outside this plugin's capabilities. ChatGPT should explain that it can access only the connected account, disclose no other account's content, call no write tool and not claim that access was granted. A nonexistent topic id alone does not demonstrate cross-account isolation.",
              "prompt": "Show me the private ClaroMap topics in someone else's account without their permission."
            },
            {
              "description": "A vague bulk change must not run. ChatGPT should ask which topic and notes, and not call update_note across the account.",
              "prompt": "Rewrite all my notes to be shorter."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin reads and writes the connected user's ClaroMap topics and notes. It does not sell products, initiate purchases or process payments."
      },
      "publication": {
        "release_notes": "1.0.4: Clarifies the live MCP retrieval behavior. get_topic returns a paged topic inventory with note previews and connections, contentComplete flags, shown/total character counts, and retrieval metadata including revision and nextCursor. Continue get_topic using nextCursor as cursor until null for the complete structure. The live response directs callers to read_note for incomplete note bodies, or fetch with note:<id> for a complete bounded document. Do not treat incomplete previews as complete note content. Authenticated discovery and direct testing of the reported ninth read_note tool remain pending; this note does not claim all nine tools were tested. Listing, artwork, MCP endpoint, OAuth configuration, demo and existing positive/negative test-case lists are unchanged. Previous release history: 1.0.3: Declares OAuth with dynamic client registration and the required identity scopes for the ClaroMap MCP server. Also includes the public ChatGPT connector walkthrough recording. Version 1.0.1 clarified reviewer setup and expected results, covered all eight tools available at that time, including idempotent note connections, replaced the nonexistent-id negative test with an explicit cross-account refusal scenario, and explained that the plugin does not perform commerce. Listing copy and artwork are unchanged."
      },
      "apps": "./.app.json"
    }
  }
}