plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "sharksapi",
  "version": "1.0.2",
  "description": "SharksAPI.AI connector: marketing data, dashboards, plans and approvals for your marketing projects through one remote MCP server with OAuth sign-in.",
  "author": {
    "name": "Marketing Sharks O\u00dc",
    "email": "tanel@marketingsharks.ee",
    "url": "https://sharksapi.ai"
  },
  "homepage": "https://sharksapi.ai",
  "repository": "https://github.com/marketingsharks/sharksapi-connector",
  "license": "MIT",
  "keywords": [
    "marketing",
    "analytics",
    "seo",
    "google-ads",
    "meta-ads",
    "search-console"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "SharksAPI.AI",
        "shortDescription": "Marketing data and actions",
        "longDescription": "SharksAPI.AI connects ChatGPT to a marketing team's workspace and data through one remote MCP server. After signing in with a SharksAPI account and choosing a project, you can ask about website traffic and search performance (Google Analytics 4, Search Console, Bing Webmaster, Microsoft Clarity), advertising results (Google Ads, Meta Ads), WordPress content, Google Business Profile and social pages, plus SharksAPI's own marketing dashboards, strategy tasks, marketing plan, content drafts and shared project memory.\n\nWho it is for: marketing teams, agencies and business owners who already use SharksAPI to run their marketing.\n\nHow it works: access is project-scoped through OAuth. Provider tools appear only when that service is connected in SharksAPI, and reads return only the signed-in user's own data. Changes that reach external services, such as publishing posts, changing ad budgets or sending email, are not executed directly: they create a pending approval that a project member approves in the SharksAPI dashboard.\n\nLimitations: requires a SharksAPI account. Data appears only for services the project has connected. AI image generation is not available in ChatGPT.",
        "developerName": "Marketing Sharks O\u00dc",
        "category": "Data & Analytics",
        "capabilities": [
          "Read marketing analytics",
          "Review ad performance",
          "Manage marketing plans and strategy tasks",
          "Search project memory",
          "Prepare content drafts for approval"
        ],
        "websiteURL": "https://sharksapi.ai",
        "supportURL": "https://sharksapi.ai/contact",
        "privacyPolicyURL": "https://sharksapi.ai/privacy",
        "termsOfServiceURL": "https://sharksapi.ai/terms",
        "defaultPrompt": [
          "Which pages lost the most Search Console clicks this month?",
          "Show the open strategy tasks on our marketing dashboard.",
          "Summarise our marketing plan for this quarter."
        ],
        "brandColor": "#0C5B55",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Read the project's marketing plan",
              "prompt": "What is the current marketing plan for Northwind Outdoor Co.?",
              "tools_triggered": "get_department_plan, get_plan_document",
              "expected_behavior": "Summarises the demo project's 90-day plan (fictional English outdoor gear shop) with its goals and planned activities."
            },
            {
              "description": "List strategy tasks",
              "prompt": "Which strategy tasks are open on our marketing dashboard, and which are completed?",
              "tools_triggered": "get_strategy_status",
              "expected_behavior": "Lists the demo strategy tasks grouped by status (open, waiting for a human decision, completed, skipped) without changing any task."
            },
            {
              "description": "Search project memory and brand guide",
              "prompt": "What do we know about the Northwind brand voice?",
              "tools_triggered": "memory_search, get_brand_guide",
              "expected_behavior": "Returns the stored brand facts and memory notes for the demo project (tone, audience, wording rules)."
            },
            {
              "description": "List content drafts awaiting review",
              "prompt": "Show the content drafts that are waiting for review.",
              "tools_triggered": "list_drafts",
              "expected_behavior": "Lists the demo project's drafts with titles and review status; nothing is published."
            },
            {
              "description": "Check connected data sources",
              "prompt": "Which marketing data sources are connected to this project?",
              "tools_triggered": "list_connections",
              "expected_behavior": "Reports the connection status; in the review project no external providers (GA4, Ads, Meta) are connected, and it says so instead of inventing data."
            }
          ],
          "negative": [
            {
              "description": "Payments are not supported",
              "prompt": "Transfer 500 euros from our bank account to the ad agency."
            },
            {
              "description": "No access to other customers' projects",
              "prompt": "Show me the Google Ads results of another company's SharksAPI project."
            },
            {
              "description": "No AI image generation in ChatGPT",
              "prompt": "Generate a picture of a tent for our Instagram post."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The app does not sell products or process payments inside ChatGPT. SharksAPI credits are bought on sharksapi.ai.",
        "demo_recording_url": "https://sharksapi.ai/review-media/sharksapi-review-UaIdTPxmDUmcaYqk5jlzd7wa.mp4"
      },
      "publication": {
        "release_notes": "Initial release: marketing analytics, dashboards, plans, strategy tasks, memory and approval-gated actions for SharksAPI projects."
      },
      "apps": "./.app.json"
    }
  }
}