{
  "version": "1.1.0",
  "tools": [
    {
      "name": "get_traffic_overview",
      "description": "Get traffic overview including total visits, human vs AI split, and top AI sources",
      "output": {
        "description": "Markdown traffic summary table, with a Top AI Sources table when source data exists.",
        "schema": {
          "type": "object",
          "required": [
            "content"
          ],
          "properties": {
            "content": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "type",
                  "text"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "text"
                  },
                  "text": {
                    "type": "string",
                    "description": "Markdown result for the requested analysis."
                  }
                }
              }
            }
          }
        }
      },
      "auth": {
        "required": true,
        "method": "Authorization: Bearer sk_live_* API key",
        "scope": "The authenticated organization only"
      },
      "errors": [
        {
          "code": "401 Unauthorized",
          "description": "The MCP connection is missing, has an invalid Bearer credential, or does not use an active sk_live_* API key."
        },
        {
          "code": "MCP tool error",
          "description": "SeeLLM could not validate the input or retrieve the requested organization data."
        }
      ],
      "docsUrl": "/docs/mcp/tools/#get_traffic_overview",
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Filter by domain"
          },
          "range": {
            "type": "string",
            "enum": [
              "7d",
              "30d",
              "90d"
            ],
            "default": "30d",
            "description": "Time range"
          }
        },
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    },
    {
      "name": "get_ai_platform_breakdown",
      "description": "Get the Search AI platform request mix with share, pages accessed, and available unique visitors",
      "output": {
        "description": "Markdown table of Search AI requests, share, pages accessed, and available unique visitors.",
        "schema": {
          "type": "object",
          "required": [
            "content"
          ],
          "properties": {
            "content": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "type",
                  "text"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "text"
                  },
                  "text": {
                    "type": "string",
                    "description": "Markdown table with Platform, Search AI Requests, Share, Pages Accessed, and Unique Visitors columns."
                  }
                }
              }
            }
          }
        }
      },
      "auth": {
        "required": true,
        "method": "Authorization: Bearer sk_live_* API key",
        "scope": "The authenticated organization only"
      },
      "errors": [
        {
          "code": "401 Unauthorized",
          "description": "The MCP connection is missing, has an invalid Bearer credential, or does not use an active sk_live_* API key."
        },
        {
          "code": "MCP tool error",
          "description": "SeeLLM could not validate the input or retrieve the requested organization data."
        }
      ],
      "docsUrl": "/docs/mcp/tools/#get_ai_platform_breakdown",
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Filter by domain"
          },
          "range": {
            "type": "string",
            "enum": [
              "7d",
              "30d",
              "90d"
            ],
            "default": "30d",
            "description": "Time range"
          }
        },
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    },
    {
      "name": "get_top_pages",
      "description": "Get meaningful content pages ranked by canonical human and AI requests for a domain",
      "output": {
        "description": "Markdown ranking table of meaningful content paths and canonical human or AI requests, or a no-data notice.",
        "schema": {
          "type": "object",
          "required": [
            "content"
          ],
          "properties": {
            "content": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "type",
                  "text"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "text"
                  },
                  "text": {
                    "type": "string",
                    "description": "Markdown result for the requested analysis."
                  }
                }
              }
            }
          }
        }
      },
      "auth": {
        "required": true,
        "method": "Authorization: Bearer sk_live_* API key",
        "scope": "The authenticated organization only"
      },
      "errors": [
        {
          "code": "401 Unauthorized",
          "description": "The MCP connection is missing, has an invalid Bearer credential, or does not use an active sk_live_* API key."
        },
        {
          "code": "MCP tool error",
          "description": "SeeLLM could not validate the input or retrieve the requested organization data."
        }
      ],
      "docsUrl": "/docs/mcp/tools/#get_top_pages",
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Domain to analyze (required)"
          },
          "range": {
            "type": "string",
            "enum": [
              "7d",
              "30d",
              "90d"
            ],
            "default": "30d",
            "description": "Time range"
          },
          "limit": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 50,
            "description": "Number of pages to return (default 10; integer from 1 to 50)"
          }
        },
        "required": [
          "domain"
        ],
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    },
    {
      "name": "get_content_valuation",
      "description": "Get estimated monetary value of content accessed by AI platforms",
      "output": {
        "description": "Markdown valuation summary with platform and content-type tables, or a no-data notice.",
        "schema": {
          "type": "object",
          "required": [
            "content"
          ],
          "properties": {
            "content": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "type",
                  "text"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "text"
                  },
                  "text": {
                    "type": "string",
                    "description": "Markdown result for the requested analysis."
                  }
                }
              }
            }
          }
        }
      },
      "auth": {
        "required": true,
        "method": "Authorization: Bearer sk_live_* API key",
        "scope": "The authenticated organization only"
      },
      "errors": [
        {
          "code": "401 Unauthorized",
          "description": "The MCP connection is missing, has an invalid Bearer credential, or does not use an active sk_live_* API key."
        },
        {
          "code": "MCP tool error",
          "description": "SeeLLM could not validate the input or retrieve the requested organization data."
        }
      ],
      "docsUrl": "/docs/mcp/tools/#get_content_valuation",
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Domain to analyze (required)"
          },
          "range": {
            "type": "string",
            "enum": [
              "7d",
              "30d",
              "90d"
            ],
            "default": "30d",
            "description": "Time range"
          }
        },
        "required": [
          "domain"
        ],
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    },
    {
      "name": "get_alerts",
      "description": "Get AI citation alerts for the organization",
      "output": {
        "description": "Markdown list of alerts with severity, type, platform, status, and creation time.",
        "schema": {
          "type": "object",
          "required": [
            "content"
          ],
          "properties": {
            "content": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "type",
                  "text"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "text"
                  },
                  "text": {
                    "type": "string",
                    "description": "Markdown result for the requested analysis."
                  }
                }
              }
            }
          }
        }
      },
      "auth": {
        "required": true,
        "method": "Authorization: Bearer sk_live_* API key",
        "scope": "The authenticated organization only"
      },
      "errors": [
        {
          "code": "401 Unauthorized",
          "description": "The MCP connection is missing, has an invalid Bearer credential, or does not use an active sk_live_* API key."
        },
        {
          "code": "MCP tool error",
          "description": "SeeLLM could not validate the input or retrieve the requested organization data."
        }
      ],
      "docsUrl": "/docs/mcp/tools/#get_alerts",
      "inputSchema": {
        "type": "object",
        "properties": {
          "limit": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 50,
            "description": "Max alerts to return (default 10; integer from 1 to 50)"
          },
          "scope": {
            "type": "string",
            "enum": [
              "open",
              "all"
            ],
            "default": "open",
            "description": "Filter by status"
          }
        },
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    },
    {
      "name": "whatif_block_platform",
      "description": "Analyze the impact of blocking an AI platform (e.g. chatgpt, perplexity)",
      "output": {
        "description": "Markdown block-impact table and recommendation, or a no-data safety message.",
        "schema": {
          "type": "object",
          "required": [
            "content"
          ],
          "properties": {
            "content": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "type",
                  "text"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "text"
                  },
                  "text": {
                    "type": "string",
                    "description": "Markdown result for the requested analysis."
                  }
                }
              }
            }
          }
        }
      },
      "auth": {
        "required": true,
        "method": "Authorization: Bearer sk_live_* API key",
        "scope": "The authenticated organization only"
      },
      "errors": [
        {
          "code": "401 Unauthorized",
          "description": "The MCP connection is missing, has an invalid Bearer credential, or does not use an active sk_live_* API key."
        },
        {
          "code": "MCP tool error",
          "description": "SeeLLM could not validate the input or retrieve the requested organization data."
        }
      ],
      "docsUrl": "/docs/mcp/tools/#whatif_block_platform",
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Domain to analyze (required)"
          },
          "platform": {
            "type": "string",
            "description": "AI platform to simulate blocking (e.g. \"chatgpt\", \"perplexity\")"
          },
          "range": {
            "type": "string",
            "enum": [
              "7d",
              "30d",
              "90d"
            ],
            "default": "30d",
            "description": "Time range"
          }
        },
        "required": [
          "domain",
          "platform"
        ],
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    },
    {
      "name": "get_weekly_trend",
      "description": "Get week-by-week traffic trend with AI vs human breakdown and per-platform detail. Great for spotting growth patterns over time.",
      "output": {
        "description": "Markdown weekly traffic table with optional AI visits by platform table.",
        "schema": {
          "type": "object",
          "required": [
            "content"
          ],
          "properties": {
            "content": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "type",
                  "text"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "text"
                  },
                  "text": {
                    "type": "string",
                    "description": "Markdown result for the requested analysis."
                  }
                }
              }
            }
          }
        }
      },
      "auth": {
        "required": true,
        "method": "Authorization: Bearer sk_live_* API key",
        "scope": "The authenticated organization only"
      },
      "errors": [
        {
          "code": "401 Unauthorized",
          "description": "The MCP connection is missing, has an invalid Bearer credential, or does not use an active sk_live_* API key."
        },
        {
          "code": "MCP tool error",
          "description": "SeeLLM could not validate the input or retrieve the requested organization data."
        }
      ],
      "docsUrl": "/docs/mcp/tools/#get_weekly_trend",
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Filter by domain"
          },
          "range": {
            "type": "string",
            "enum": [
              "30d",
              "90d"
            ],
            "default": "30d",
            "description": "Time range (30d or 90d)"
          }
        },
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    }
  ]
}
