.codex-plugin/plugin.json

{
  "name": "runner",
  "version": "1.0.2",
  "description": "Ask how your business is doing and get answers from your own Runner workspace: website traffic and sources, ad spend and performance across Google, Meta, LinkedIn and Reddit, open deals by stage, revenue and MRR, the content calendar, and what needs your attention today. Read-only: it never sends, posts, changes an ad or approves anything, and it never returns people's contact details.",
  "author": {
    "name": "SHMAPLEX",
    "email": "team@runtheworld.ai",
    "url": "https://www.runtheworld.ai"
  },
  "homepage": "https://www.runtheworld.ai",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Runner",
    "shortDescription": "Traffic, ads, deals & revenue",
    "longDescription": "Ask how your business is doing and get the answer from your own Runner workspace \u2014 the traffic, ads, pipeline, revenue and content you already run there.\n\nConnect Runner, choose which of your products ChatGPT may read, and ask in plain words:\n\n\u2022 \"How did my product do this week?\" \u2014 visits, new contacts, new deals, closed revenue and what changed against the week before, in one answer.\n\u2022 \"Are our ads running, and what did we spend?\" \u2014 every connected ad channel (Google Ads, Meta, LinkedIn, Reddit) with its status, spend, clicks and conversions, your managed budget's pace, and any ad changes waiting for approval.\n\u2022 \"Where is our traffic coming from?\" \u2014 first-party visits and sources, the daily Google Analytics sessions Runner has stored, and your top Google Search Console queries.\n\u2022 \"What deals are open?\" \u2014 open opportunities by stage and value, recent wins and losses, and the deals whose next step is overdue.\n\u2022 \"How much revenue did we make this month?\" \u2014 net revenue, refunds and fees by currency, and MRR movement, from the revenue ledger Runner keeps from Stripe.\n\u2022 \"What's scheduled to post?\" \u2014 the content calendar across channels and what went out recently.\n\u2022 \"What needs my attention today?\" \u2014 approvals waiting on you, conversations waiting for a reply, and follow-ups that are overdue.\n\u2022 \"Which companies are hot right now?\" and \"Are we on track for our growth target?\"\n\nWhat it does not do. This connection only reads. It never sends, posts, pauses an ad, changes a budget or approves anything \u2014 those stay in Runner, where the approval steps are. It does not return the personal details of your contacts (no names, email addresses or phone numbers); it works with companies, deals, campaigns and totals.\n\nYou stay in control. You sign in with your Runner account and pick the products the connection can see. Every request is checked against your own Runner role at that moment, so it never shows more than you could see in Runner yourself. Each call is recorded in your workspace's audit log, and you can disconnect at any time from Settings \u2192 MCP clients in Runner.\n\nRunner reads stored numbers and never invents a zero: when a channel isn't connected or hasn't synced yet, it says so.",
    "developerName": "SHMAPLEX",
    "category": "Business & Operations",
    "capabilities": [
      "Business overview: this week against last",
      "Website traffic, sources and Search Console queries",
      "Ad status, spend and performance across four channels",
      "Open deals by stage, wins, losses and overdue follow-ups",
      "Revenue and MRR by currency",
      "Content calendar and recent posts",
      "Approvals and conversations waiting on you"
    ],
    "websiteURL": "https://www.runtheworld.ai",
    "supportURL": "https://www.runtheworld.ai/support",
    "privacyPolicyURL": "https://www.runtheworld.ai/privacy",
    "termsOfServiceURL": "https://www.runtheworld.ai/terms",
    "defaultPrompt": [
      "How did my product do this week?",
      "Are our ads running, and what did we spend?",
      "What needs my attention today?"
    ],
    "brandColor": "#E0187C",
    "composerIcon": "./assets/composer-icon.png",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "A weekly business check-in for one product.",
              "prompt": "How did Northwind Studio do this week?",
              "tools_triggered": "projects_list, business_overview",
              "expected_behavior": "Lists the products to find Northwind Studio, then summarises the last 7 days against the 7 before: visits, contacts created, deals created, closed-won revenue with its currency, each connected ad channel's status and yesterday's spend, and the counts of items needing attention. Sources that are not connected are named as not connected rather than shown as zero."
            },
            {
              "description": "Whether ads are running and what they cost.",
              "prompt": "Are our ads running for Northwind Studio, and what did we spend in the last 7 days?",
              "tools_triggered": "projects_list, ads_overview",
              "expected_behavior": "For each ad channel (Google Ads, Meta, LinkedIn, Reddit): connected or not, active campaign count, spend, clicks and conversions for the window with the account currency, the managed budget's pace, and how many ad changes are waiting for approval in Runner."
            },
            {
              "description": "Where website traffic comes from.",
              "prompt": "Where is Northwind Studio's website traffic coming from this month?",
              "tools_triggered": "projects_list, analytics_traffic_summary",
              "expected_behavior": "The top traffic sources (source, medium, campaign) over the last 28 days with event counts, the visit pace, and Google Analytics daily sessions and active users if a GA4 property is connected \u2014 otherwise it says GA4 is not connected."
            },
            {
              "description": "Open deals and overdue follow-ups.",
              "prompt": "What deals are open for Northwind Studio, and which follow-ups are overdue?",
              "tools_triggered": "projects_list, pipeline_summary",
              "expected_behavior": "Open opportunities grouped by stage with counts and value per currency, recent wins and losses, and the largest open deals with their account, stage, expected close date and whether the next step is overdue."
            },
            {
              "description": "The day's to-do list across Runner.",
              "prompt": "What needs my attention today in Northwind Studio?",
              "tools_triggered": "projects_list, attention_today",
              "expected_behavior": "Approvals waiting, conversations waiting for a reply, and overdue or unowned next actions, each with a count, the top items and a link path into Runner. No message content or contact details are shown."
            }
          ],
          "negative": [
            {
              "description": "Asking it to change an ad. Every tool is read-only, so the model should say it can only read and point to the Ads page in Runner, where changes go through approval.",
              "prompt": "Pause the Google Ads campaign that's overspending."
            },
            {
              "description": "Asking for people's contact details. No tool returns names, email addresses or phone numbers, so the model should decline and offer counts instead.",
              "prompt": "Give me the email addresses of everyone who signed up this week."
            },
            {
              "description": "Asking about a business the connection was not granted. Tools refuse any product outside the connection, so nothing is returned.",
              "prompt": "Show me the revenue for a competitor's workspace."
            }
          ]
        },
        "demo_recording_url": "https://storage.googleapis.com/shmaplex-runner-public/screencasts/runner-chatgpt-demo.mp4",
        "commerce": false
      },
      "publication": {
        "release_notes": "First release. Connect Runner and ask about your business in plain words: a weekly overview, website traffic and sources, Search Console queries, ad status and spend, open deals, revenue and MRR, the content calendar, hot companies, your growth target, and what needs your attention today. Every tool is read-only, and you choose which products the connection can see."
      }
    }
  },
  "apps": "./.app.json"
}