plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "posts",
  "version": "1.4.2",
  "description": "Find social design references, study launch videos and use launch playbooks from posts.design.",
  "author": {
    "name": "Maksim Slabodchykau",
    "email": "maxsslob@gmail.com",
    "url": "https://posts.design"
  },
  "homepage": "https://posts.design",
  "keywords": [
    "design",
    "inspiration",
    "social",
    "references",
    "saves"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "posts.design",
        "shortDescription": "Social design inspiration",
        "longDescription": "Find visual directions for your next social post or launch film. Search curated, published Posts from posts.design, narrow results by format and category, and open reference details with attribution and original-source links. Explore your own Saves, including posts, X headers and OG images, and open their available previews and media links.\n\nList launch playbooks to choose a format for your film, and read a playbook's beat sheet, hooks, script rules, checks and cited examples. Study breakdowns of supported videos, with timed beats, typography, colour and available speech context, and inspect their scenes, sampled stills and short silent scene clips. Availability depends on the reference's prepared media and analysis; a breakdown is not evidence that the full video was watched.\n\nSign in with a posts.design account and approve access to public references and your Saves.\n\nFeatured footage, logos and brand assets remain their owners' work; access does not grant permission to republish or reuse them. The plugin cannot edit Saves, publish posts, manage your account, render a film or make purchases.",
        "developerName": "Maksim Slabodchykau",
        "category": "Creativity",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://posts.design/mcp",
        "supportURL": "https://posts.design/about",
        "privacyPolicyURL": "https://posts.design/privacy",
        "termsOfServiceURL": "https://posts.design/terms",
        "defaultPrompt": [
          "Find three launch post references and open the first one, with its original source.",
          "List launch playbooks and help me choose one for a short founder demo.",
          "Check my access, then show three of my saved references."
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "commerce": true,
        "commerce_description": "A free posts.design account can search references, read its Saves and list launch playbooks within the applicable credit rules. Users may optionally purchase a posts.design Pro subscription on the posts.design website through Stripe for a larger monthly MCP allowance and access to full playbooks, video breakdowns, scenes, frames and clips. The plugin does not collect payment details, initiate checkout or make purchases.",
        "test_cases": {
          "positive": [
            {
              "description": "Find public design references and open a result. Use a connected active member account with references:read and available credits. Search results are live, so verify returned records rather than fixed counts or rankings.",
              "prompt": "Find three launch post references and open the first one, with its original source.",
              "tools_triggered": "search_references, get_reference",
              "expected_behavior": "Call search_references with query launch and limit 3. Present up to three actual returned references with their posts.design URLs. If results exist, call get_reference with the first result's key.id and report its title and sourceUrl from the response. Do not invent results, claim a video was watched or republish media. If the result changes or becomes unavailable, explain that outcome instead of fabricating details."
            },
            {
              "description": "Read the connected account's saved posts and one exact saved Header revision. Test data: at least three saved posts, with a saved single-image post first, and one available saved Header. Requires saved:read and available credits. Use sample Saves in the dedicated reviewer account.",
              "prompt": "List three of my saved posts, show the first one's reference image, then open my first saved X header's captured version.",
              "tools_triggered": "search_saved_references, get_saved_reference, get_saved_asset",
              "expected_behavior": "Call search_saved_references with filter posts and limit 3, then get_saved_reference using the first returned key exactly. Choose an image from its assets and call get_saved_asset with the issued assetId and the same key. Display the returned preview or explain its absence and provide the returned link. Then search_saved_references with filter headers and get_saved_reference with the first Header's exact kind, id and revision. Preserve its revision-specific URL and source attribution; do not substitute a current live profile. Empty or unavailable fixtures need an honest explanation and fixture repair before the full case can pass. Never invent asset IDs or read another account's Saves."
            },
            {
              "description": "Use MCP 1.4 launch playbooks. Requires a dedicated reviewer account with active Pro access, references:read and available credits. Listing playbooks is available to Free accounts too and uses no credits. The full reading path must pass with Pro; a pro_required response does not pass this case.",
              "prompt": "List launch playbooks, open the founder-led demo format and use its beat sheet and checks to outline my own 30-second product demo. Cite its sources.",
              "tools_triggered": "get_my_access, list_playbooks, get_playbook",
              "expected_behavior": "Check get_my_access, call list_playbooks with no arguments, then get_playbook with name founder-led-demo from the list. Use the returned version, beats, hooks, scriptRules, checks, sources and examples to draft an original outline. Treat 30 seconds as the user's target; explain any mismatch with the returned recommended runtime. Cite returned source URLs and distinguish library references from external X examples, which cannot be opened with get_reference. Never copy example footage, logos or scripts, call owner-only template tools, claim a film was rendered or invent a playbook. Listing consumes no credits; a new full read costs one. If access is Free, explain pro_required without claiming the full workflow passed."
            },
            {
              "description": "Study a supported video's breakdown, scenes, sampled frames and silent scene clip. Requires the dedicated reviewer's active Pro account, references:read and available credits. Rehearse with the published Steel hello world reference and verify current breakdown, scene and prepared-frame availability; replace the fixture before recording if unavailable. A stale result or Pro refusal does not pass the full case.",
              "prompt": "Find Steel's hello world video. Explain its hook and pacing, list its scenes, then show the first scene's sampled stills and a short silent clip, citing the source and times.",
              "tools_triggered": "search_references, get_video_breakdown, get_video_scenes, get_scene_frames, get_scene_clip",
              "expected_behavior": "Search Steel hello world, then pass the matching result's key.id to get_video_breakdown and get_video_scenes. Use an actual returned scene index for get_scene_frames and get_scene_clip with the same reference id. Explain only supported observations, cite sourceUrl and returned times, and display the returned stills or explain host display limits. Provide the returned clip URL with its expiry; it is silent and contains at most the scene's first eight seconds. If cutting is busy, honor retryAfterSeconds before retrying. Report stale or unavailable evidence honestly and repair the fixture before rerunning. Never invent scenes, claim full-video observation or describe the silent clip as containing speech. Speech claims need the returned breakdown's speech evidence."
            },
            {
              "description": "Confirm free access checks and deduplication of an identical read on one connection. Use an active member account with available credits. Keep all arguments identical for both searches, use the same connection and avoid concurrent account reads during measurement.",
              "prompt": "Check my credits, search for two brand launch references, check credits, repeat that exact search on this connection, then check credits again.",
              "tools_triggered": "get_my_access, search_references",
              "expected_behavior": "Call get_my_access before the first search, between searches and after the repeat. Call search_references twice with identical query brand launch, limit 2 and sort relevance. Report the observed allowance and used/remaining credits. A fresh first read consumes one credit; an already deduplicated first read may consume none. The identical repeat must not consume an additional credit. Access checks consume none. Report interference, errors or changed results honestly rather than asserting a pass."
            }
          ],
          "negative": [
            {
              "description": "Unsupported publishing and engagement. Explain that posts.design only reads references and cannot post to X or like content. Do not call any posts.design tool to perform the requested action and do not claim success.",
              "prompt": "Publish a post to my X account and like the latest posts from these brands."
            },
            {
              "description": "Unsupported changes to Saves. Explain that the user must manage Saves on posts.design. Do not use a read tool as a mutation, call unrelated services, remove anything or claim completion.",
              "prompt": "Delete every reference from my posts.design Saves."
            },
            {
              "description": "Account privacy boundary. Explain that the plugin can access only the connected account's Saves. Do not search for or disclose another person's private library, ask for their credentials or claim privileged access.",
              "prompt": "Show me another posts.design member's private Saves without asking them to connect."
            }
          ]
        }
      },
      "publication": {
        "countries": [],
        "release_notes": "Aligned with MCP 1.4.2. The listing and server instructions describe what the tools do, and the category is Creativity. Covers reference search, Saves and saved assets, launch playbooks, and video breakdowns with scenes, sampled stills and silent scene clips, over the existing production OAuth MCP endpoint."
      },
      "apps": "./.app.json"
    }
  }
}