{
  "protocolVersion": "0.3.0",
  "name": "Serql Search Console analyst",
  "description": "Answers questions about a website's Google Search Console performance and produces SEO analyses (branded vs. non-branded, cannibalization, growth opportunities, trend insights) for properties the authorizing user can access. Exposed as an MCP server; the A2A card describes the same capabilities for discovery.",
  "url": "https://www.serql.io/mcp",
  "preferredTransport": "JSONRPC",
  "additionalInterfaces": [
    {
      "url": "https://www.serql.io/mcp",
      "transport": "MCP"
    },
    {
      "url": "https://app.serql.io/api",
      "transport": "HTTP+JSON"
    }
  ],
  "supportedInterfaces": [
    {
      "url": "https://www.serql.io/mcp",
      "protocolBinding": "MCP",
      "protocolVersion": "2025-06-18"
    },
    {
      "url": "https://app.serql.io/api",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "Serql",
    "url": "https://www.serql.io/"
  },
  "iconUrl": "https://www.serql.io/web-app-manifest-512x512.png",
  "version": "dev",
  "documentationUrl": "https://www.serql.io/docs/agents",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "securitySchemes": {
    "oauth2": {
      "type": "oauth2",
      "description": "OAuth 2.0 authorization code with PKCE (S256) issued by https://clerk.serql.io. Protected resource metadata: https://app.serql.io/.well-known/oauth-protected-resource/api/mcp.",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://clerk.serql.io/oauth/authorize",
          "tokenUrl": "https://clerk.serql.io/oauth/token",
          "scopes": {
            "openid": "Identity",
            "profile": "Profile",
            "email": "Email"
          }
        }
      }
    }
  },
  "security": [
    {
      "oauth2": [
        "openid",
        "profile",
        "email"
      ]
    }
  ],
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/markdown"
  ],
  "skills": [
    {
      "id": "portfolio-monitoring",
      "name": "Portfolio monitoring",
      "description": "Every Google Search Console property from every connected Google account on one dashboard with clicks, impressions, CTR, position, period-over-period deltas, tags, favorites, and sparklines.",
      "tags": [
        "seo",
        "google-search-console",
        "analytics",
        "portfolio-monitoring"
      ],
      "examples": [
        "Which of my sites lost the most clicks in the last 14 days?",
        "List all the Search Console properties I manage with this week's KPIs."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "performance-explorer",
      "name": "Performance explorer",
      "description": "Query, page, country, device, and search-appearance breakdowns beyond the Search Console UI's 1,000-row limit, with five-dimension filtering, comparison date ranges, daily/weekly/monthly aggregation, and CSV export.",
      "tags": [
        "seo",
        "google-search-console",
        "analytics",
        "performance-explorer"
      ],
      "examples": [
        "Show the top 50 queries for example.com over the last 28 days compared with the previous period.",
        "Export all pages with more than 100 impressions and CTR under 2%."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "classifications",
      "name": "Classifications (segments and topic clusters)",
      "description": "Rule-based query and page groups such as branded vs. non-branded, product lines, or content types, evaluated live over the full dataset without regex.",
      "tags": [
        "seo",
        "google-search-console",
        "analytics",
        "classifications"
      ],
      "examples": [
        "How much of my traffic is branded vs. non-branded?",
        "Compare the 'blog' segment against the 'product pages' segment this month."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "cannibalization",
      "name": "Cannibalization detection",
      "description": "Finds pages on the same property competing for the same queries so teams can consolidate or differentiate them.",
      "tags": [
        "seo",
        "google-search-console",
        "analytics",
        "cannibalization"
      ],
      "examples": [
        "Which pages on my site are cannibalizing each other?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "growth-opportunities",
      "name": "Growth opportunities",
      "description": "Surfaces striking-distance queries (best position 4-20), each with an estimated click gain at position 3 and the page to fix, ready to convert with on-page work.",
      "tags": [
        "seo",
        "google-search-console",
        "analytics",
        "growth-opportunities"
      ],
      "examples": [
        "Which striking-distance keywords have the biggest estimated gain, and which page should I fix for each?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "trend-detection",
      "name": "Trend detection",
      "description": "Rising and decaying queries and pages, with Google's confirmed core updates overlaid on every chart.",
      "tags": [
        "seo",
        "google-search-console",
        "analytics",
        "trend-detection"
      ],
      "examples": [
        "Which queries are growing fastest this month?",
        "Did the last Google core update hurt my rankings?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "annotations",
      "name": "Annotations",
      "description": "Custom notes for site changes and campaigns, plus automatic Google algorithm-update annotations on performance charts.",
      "tags": [
        "seo",
        "google-search-console",
        "analytics",
        "annotations"
      ],
      "examples": [
        "Add an annotation for the site migration on 2026-08-01."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "sharing",
      "name": "Teams and shareable reports",
      "description": "Per-property collaborator roles and white-label, read-only share links that anyone can view without an account.",
      "tags": [
        "seo",
        "google-search-console",
        "analytics",
        "sharing"
      ],
      "examples": [
        "Create a read-only share link for the client report."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    }
  ],
  "contact": {
    "email": "support@serql.io"
  }
}