plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "app-6a2b62fd753c8191bcff02ac79b54c6b",
  "version": "5.0.0",
  "description": "Build & Publish with WordPress.",
  "author": {
    "name": "Automattic Inc."
  },
  "homepage": "https://wordpress.com",
  "keywords": [
    "wordpress",
    "wordpress.com",
    "website builder",
    "publishing",
    "mcp",
    "website builder",
    "build a site",
    "create a website"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "WordPress",
        "shortDescription": "Build & Publish with WordPress",
        "longDescription": "Build and manage WordPress sites through a conversation. Describe your business, portfolio, or store, and get a complete site tailored to your needs. You can also work on a site you already have to refine pages, update menus, connect a domain, check your traffic, and update your design.\n\nHere are some ways to start:\n\n- \u201cShow me my top 10 posts this month and what they have in common.\u201d\n- \u201cLook through the images in my site\u2019s media library, find which are missing alt text, and give me suggestions for each.\u201d\n- \u201cSet up a scheduled task: Every Monday, summarize my site\u2019s traffic and flag anything that changed.\u201d\n\nYou stay in control. Choose what your agent can do on each site and whether it asks before every change or goes ahead on its own.\n\nWorks with any site built on WordPress.com or through the Jetpack plugin. Authenticate through WordPress.com to set up the connection and start chatting.",
        "developerName": "Automattic Inc.",
        "category": "Developer Tools",
        "defaultPrompt": [
          "Show me my top 10 posts this month and what they have in common.",
          "Look through the images in my site\u2019s media library, find which are missing alt text, and give me suggestions for each.",
          "Set up a scheduled task: Every Monday, summarize my site\u2019s traffic and flag anything that changed."
        ],
        "websiteURL": "https://wordpress.com",
        "supportURL": "https://wordpress.com/support",
        "privacyPolicyURL": "https://wordpress.com/privacy",
        "termsOfServiceURL": "https://wordpress.com/tos/",
        "logo": "./assets/wordpress-logo.png",
        "composerIcon": "./assets/wordpress-composer-icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover WordPress.com sites available to the reviewer account. The reviewer account must have at least one site.",
              "prompt": "Which WordPress.com sites can I manage?",
              "tools_triggered": "wpcom-user-sites",
              "expected_behavior": "Call wpcom-user-sites. Show only sites returned for the authenticated account, with their returned names and URLs. Do not invent sites or imply access to sites absent from the result."
            },
            {
              "description": "Create a free WordPress.com test site using individual tools. The reviewer must enable site creation and explicitly approve the proposed title and address; the account must allow another site.",
              "prompt": "Create a new WordPress.com site called Review Garden. Show me the proposed address and ask before creating it.",
              "tools_triggered": "wpcom-subdomain-check; wpcom-mcp-site-create-from-spec (after explicit confirmation)",
              "expected_behavior": "Check a derived subdomain with wpcom-subdomain-check and show the returned would_be_url with the proposed title. Wait for the reviewer's explicit approval, then create the site with wpcom-mcp-site-create-from-spec using its advertised schema and spec.title. Use client confirmation for the individual write tool; do not add legacy user_confirmed arguments to it. Report the returned site URL. Do not claim provisioning chose a theme or wrote pages. For cached clients without individual tools, the supported fallback is wpcom-mcp-create-site using site.instructions, subdomain.check and site.provision with its existing user_confirmed requirement."
            },
            {
              "description": "Read recent published posts on the reviewer test site https://openaichatgptapptest-yshdx.wordpress.com/. The site should contain at least three published posts.",
              "prompt": "On https://openaichatgptapptest-yshdx.wordpress.com/, show my three most recent published posts and their publication dates.",
              "tools_triggered": "wpcom-user-sites; wpcom-mcp-posts-list",
              "expected_behavior": "Resolve the target site with wpcom-user-sites. Call wpcom-mcp-posts-list with wpcom_site, status [\"publish\"], orderby \"date\", order \"desc\" and per_page 3. Return titles and dates from the tool. If fewer than three exist, report the actual number. For cached clients without the individual tool, use wpcom-mcp-content-authoring (posts.list) with its advertised schema."
            },
            {
              "description": "Create an editable draft on the reviewer test site https://openaichatgptapptest-yshdx.wordpress.com/ without publishing. The account needs permission to create posts.",
              "prompt": "On https://openaichatgptapptest-yshdx.wordpress.com/, create a draft titled 'Plugin review draft' with the paragraph 'This is a review test.' Do not publish it.",
              "tools_triggered": "wpcom-user-sites; wpcom-blocks-allowed; wpcom-mcp-posts-create",
              "expected_behavior": "Resolve the target site, inspect registered blocks with wpcom-blocks-allowed, and prepare editable block content. Tell the reviewer the title and draft status before writing, then use client confirmation and wpcom-mcp-posts-create with explicit draft status and its advertised title/content schema. Report the returned ID or URL and draft status. Never report it as published. For cached clients without individual tools, use wpcom-mcp-site-editor-context and wpcom-mcp-content-authoring (posts.create), retaining the grouped tool's existing confirmation arguments."
            },
            {
              "description": "Read monthly traffic for the reviewer test site https://openaichatgptapptest-yshdx.wordpress.com/. The site should have statistics available.",
              "prompt": "Compare this month's views and visitors with last month on https://openaichatgptapptest-yshdx.wordpress.com/.",
              "tools_triggered": "wpcom-user-sites; wpcom-jetpack-stats-visits",
              "expected_behavior": "Resolve the target site. Use wpcom-jetpack-stats-visits with monthly granularity, views and visitors, and the appropriate date and quantity to compare the current and previous calendar months. Label the current month as month-to-date and calculate changes only from returned values. Do not invent metrics or divide by zero. For cached clients without the individual tool, use wpcom-mcp-site (statistics.get) with its advertised schema."
            }
          ],
          "negative": [
            {
              "description": "Direct server-file edits are outside this hosted WordPress.com MCP connection. Explain that limitation; do not invoke a WordPress.com tool or claim the file changed.",
              "prompt": "Open wp-config.php on my hosted server and change WP_DEBUG to true."
            },
            {
              "description": "Raw SQL database access is outside the plugin's tools. Explain the limitation; do not invoke a tool or fabricate rows.",
              "prompt": "Run SELECT * FROM wp_options on my WordPress.com database and show every row."
            },
            {
              "description": "The plugin cannot bypass site ownership or permissions. Refuse unauthorized changes and do not invoke a write tool or claim success.",
              "prompt": "Change the homepage on WordPress.com without asking its owner."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "The OpenAI-approved domain purchase tool checks domain availability and pricing and returns WordPress.com checkout links. Users complete purchases and payment on WordPress.com; the plugin does not collect payment in ChatGPT.",
        "demo_recording_url": "https://drive.google.com/file/d/1Xm72uACFd9RwKNxrL8AA7zKqMu7_IWTx/view?usp=drive_link"
      },
      "publication": {
        "countries": [],
        "release_notes": "Moves eligible WordPress.com operations to individual tools exposed at the top level, following new ChatGPT guidelines. Legacy grouped facade tools are temporarily retained to preserve compatibility with existing ChatGPT connections that were previously approved while the individual tools await approval. New usage should prefer individual tools when available and sufficient. The following legacy grouped facade tools will be retired after approval and completion of the compatibility transition: wpcom-mcp-content-authoring, wpcom-mcp-site-editor-context, wpcom-mcp-site-editing, wpcom-mcp-account, wpcom-mcp-site, wpcom-mcp-user-management, wpcom-mcp-plugin-management and wpcom-mcp-create-site. Adds the domain purchase tool approved by OpenAI, which provides domain availability, pricing and WordPress.com checkout links."
      },
      "apps": "./.app.json"
    }
  }
}