{
  "$schema": "https://modelcontextprotocol.io/schemas/server-card/v1.json",
  "name": "ytbrain",
  "title": "YTBrain Universal MCP Server",
  "version": "1.0.0",
  "description": "Universal Model Context Protocol (MCP) gateway for YouTube growth intelligence, competitor discovery, SERP rank tracking, video auditing, and keyword volume metrics.",
  "homepage": "https://ytbrain.com",
  "endpoint": "https://ytbrain.com/api/mcp",
  "transport": "http",
  "protocolVersion": "2024-11-05",
  "capabilities": {
    "tools": {
      "listChanged": false
    },
    "resources": {},
    "prompts": {},
    "logging": {}
  },
  "authentication": {
    "type": "bearer",
    "description": "API Key or OAuth Bearer token required for protected workspace tools. Handshake and public directory discovery are open without credentials.",
    "tokenUrl": "https://ytbrain.com/api/auth/token",
    "authorizationUrl": "https://ytbrain.com/oauth/authorize"
  },
  "tools": [
    {
      "name": "search_keywords_intelligence",
      "description": "Retrieve search volume, CPC, competition score, and growth trends for keywords and topics.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Target search keyword or topic" },
          "country": { "type": "string", "description": "2-letter ISO country code, default US" }
        },
        "required": ["query"]
      }
    },
    {
      "name": "audit_video_intelligence",
      "description": "Deep audit of a YouTube video including title hooks, thumbnail contrast, tags, SEO score, and retention signals.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "videoUrl": { "type": "string", "description": "YouTube video URL or Video ID" }
        },
        "required": ["videoUrl"]
      }
    },
    {
      "name": "discover_competitors",
      "description": "Find top competing YouTube channels in a niche with subscriber velocity and upload frequency analysis.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "niche": { "type": "string", "description": "Target niche topic or channel category" }
        },
        "required": ["niche"]
      }
    },
    {
      "name": "track_serp_rankings",
      "description": "Get current search engine rank positions of channel videos across tracked YouTube search queries.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "channelId": { "type": "string", "description": "YouTube Channel ID" }
        },
        "required": ["channelId"]
      }
    },
    {
      "name": "generate_creator_report",
      "description": "Generate an executive PDF or markdown growth intelligence report for a channel.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "channelId": { "type": "string", "description": "YouTube Channel ID" },
          "format": { "type": "string", "enum": ["summary", "markdown", "pdf"], "default": "markdown" }
        },
        "required": ["channelId"]
      }
    }
  ],
  "contact": {
    "email": "support@ytbrain.com",
    "url": "https://ytbrain.com/contact"
  }
}

