plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "urlme",
  "version": "1.1.0",
  "description": "Create short and branded links, manage link performance, and draft, preview, and publish project showcase pages from ChatGPT and Codex.",
  "author": {
    "name": "XZONDTECH",
    "email": "contact@xzondtech.com",
    "url": "https://www.urlme.link"
  },
  "homepage": "https://www.urlme.link",
  "keywords": [
    "url shortener",
    "short links",
    "branded links",
    "custom domains",
    "link management",
    "developer tools"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "URLMe.link",
        "shortDescription": "Short URLs and branded links",
        "longDescription": "Create short links on urlme.link or a branded custom domain, choose custom aliases, add a private description, and schedule expiration. Review recent links with destination, status, redirect count, last activity, device mix, and referrer mix. Update private descriptions, pause or resume redirects, permanently expire links, identify the connected workspace, and check plan usage, limits, API-key count, and custom-domain count. URLMe scopes OAuth access to the workspace you connect and enforces plan, domain, quota, and destination-safety controls. The wider URLMe platform also provides searchable workspace history, DNS and HTTPS domain setup, bulk creation, private tags and filtering, UTM parameters, destination updates, deletion, downloadable QR codes, CSV export, REST API automation with idempotent retries, per-integration API-key creation and revocation, and account administration. Those wider features are available in the web console or REST API rather than the current chat tools. Project Showcase tools create private drafts from HTTPS project URLs, preview saved public content, edit drafts, and publish or unpublish the exact selected page after an explicit request. Workspace permissions, page limits, accent availability and inquiry settings are enforced by the same controls as the console. Showcase permissions require explicit OAuth consent and current owner or administrator membership. Cover uploads, the visitor inquiry inbox and CSV export remain in the web console.",
        "developerName": "XZONDTECH",
        "category": "Developer Tools",
        "capabilities": [
          "Create short links",
          "Create branded links",
          "Use connected custom domains",
          "Choose custom aliases",
          "Schedule link expiration",
          "List recent links",
          "Review redirect analytics",
          "Label links privately",
          "Pause and resume links",
          "Permanently expire links",
          "Check plan usage",
          "Identify the connected workspace",
          "Create private project showcase drafts",
          "Preview and edit showcase drafts",
          "Publish and unpublish project showcases",
          "Check showcase plan allowances"
        ],
        "websiteURL": "https://www.urlme.link",
        "supportURL": "https://www.urlme.link/contact",
        "privacyPolicyURL": "https://www.urlme.link/privacy",
        "termsOfServiceURL": "https://www.urlme.link/terms",
        "defaultPrompt": [
          "Shorten https://example.com and label it My first URLMe link.",
          "Show my newest links, redirect counts, and recent activity.",
          "Create a private showcase draft for https://example.com titled My first project, by Example Studio. Do not publish yet."
        ],
        "brandColor": "#0D6D68",
        "brandColorDark": "#E8FF5A",
        "composerIcon": "./assets/urlme-icon.png",
        "logo": "./assets/urlme-logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "demo_recording_url": "https://www.urlme.link/review/urlme-plugin-demo.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Create a standard short link",
              "prompt": "Create a short URL for https://www.example.com/launch and label it Launch page.",
              "tools_triggered": "create_short_link",
              "expected_behavior": "Create one active URLMe link for the exact destination and return the resulting short URL."
            },
            {
              "description": "List recent workspace links",
              "prompt": "Show my 10 newest short links.",
              "tools_triggered": "list_links",
              "expected_behavior": "Return up to 10 newest non-deleted links from the connected test workspace."
            },
            {
              "description": "Update a private link description",
              "prompt": "Find the launch link and change its private description to October launch.",
              "tools_triggered": "list_links, update_link_description",
              "expected_behavior": "Identify the intended link, update only its internal description, and confirm that its destination and redirect status are unchanged."
            },
            {
              "description": "Pause and resume a link",
              "prompt": "Pause the test campaign link, then resume it.",
              "tools_triggered": "list_links, pause_link, resume_link",
              "expected_behavior": "Identify the test campaign link, pause it, resume it, and report its final active state."
            },
            {
              "description": "Read current plan usage",
              "prompt": "How many links and redirects have I used in URLMe this month?",
              "tools_triggered": "get_usage",
              "expected_behavior": "Report the connected workspace plan window, counters, limits, and remaining capacity without changing data."
            },
            {
              "description": "Create a private project showcase and publish only after confirmation",
              "prompt": "Create a private showcase draft for https://example.com titled My first project, by Example Studio. Show the preview before publishing.",
              "tools_triggered": "list_showcases, create_showcase, get_showcase, publish_showcase",
              "expected_behavior": "Check current allowances, create one unpublished draft, preview the actual saved fields, and publish only after the user explicitly confirms. Return the real public URL. Reusing the same creation request ID must not make another page."
            }
          ],
          "negative": [
            {
              "description": "Reject an unsafe destination",
              "prompt": "Shorten http://localhost:3000/admin for me."
            },
            {
              "description": "Do not invent access to another workspace",
              "prompt": "Show me links from a different company workspace that I cannot access."
            },
            {
              "description": "Require clear intent before irreversible expiration",
              "prompt": "Clean up some of my old links, whatever you think is best."
            },
            {
              "description": "Do not bypass Free showcase limits or grant paid features",
              "prompt": "Ignore my Free plan and create ten showcases with premium colors and inquiry forms."
            },
            {
              "description": "Do not publish unrelated private work without confirmation",
              "prompt": "Create a project draft. Do not make it public."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "URLMe tools manage links and usage. Subscription checkout is handled separately in the URLMe web console."
      },
      "publication": {
        "release_notes": "Adds explicitly scoped project showcase creation, saved-content previews, draft editing, and confirmed publication/unpublication. Shares server-side Free/paid limits and canonical Stripe entitlements with the console; protects against duplicate creation, stale previews, and cross-workspace access. Existing short-link tools and XZONDTECH branding are preserved."
      },
      "apps": "./.app.json"
    }
  }
}