---
title: MCP Tools Reference
description: Complete reference for all SeeLLM MCP tools available to AI assistants.
audience: [human, agent]
type: reference
version: v1
stability: stable
lastVerified: "2026-08-02"
prerequisites: [/docs/mcp/setup/]
related: [/docs/mcp/, /docs/guides/weekly-trends/, /docs/guides/blocking-platforms/]
artifacts: [{ label: MCP tools manifest, url: /docs/mcp/tools.json }]
---

## Contract

SeeLLM's MCP server exposes seven read-only tools for the authenticated organization. Machines can use the versioned [MCP tools manifest](/docs/mcp/tools.json), which includes the JSON Schema inputs, output shape, authentication requirement, errors, and a link back to this reference.

Every successful call returns this MCP result shape. `text` is Markdown, with the headings and tables noted for each tool below.

```json
{
  "content": [{ "type": "text", "text": "# Result heading\n\n..." }]
}
```

All tools require `Authorization: Bearer sk_live_…`; the MCP endpoint accepts active SeeLLM API keys, not Firebase JWTs. They return data only for the authenticated organization. Missing, invalid, expired, or non-API-key credentials return HTTP `401 Unauthorized`. MCP rejects input that does not match the documented schema before the handler runs; data-retrieval failures are surfaced as MCP tool errors.

## Available Tools

### get_traffic_overview

Gets total visits, the human/AI split, and the top AI sources.

| Input | Type | Default | Description |
|---|---|---|---|
| `domain` | string | — | Optional domain filter |
| `range` | `7d` \| `30d` \| `90d` | `30d` | Time range |

**Output:** `# Traffic Overview` followed by a total/human/AI/other-automated/AI-percent table. The four traffic counts reconcile: total equals human plus AI plus other automated. If data exists, it also includes a `## Top AI Sources` table (up to 10 sources).

**Example prompt:** “Show me my traffic overview for the last 7 days.”

### get_ai_platform_breakdown

Gets the observed Search AI request mix by platform. This is narrower than all AI traffic and does not prove citation.

| Input | Type | Default | Description |
|---|---|---|---|
| `domain` | string | — | Optional domain filter |
| `range` | `7d` \| `30d` \| `90d` | `30d` | Time range |

**Output:** `# Search AI Platform Breakdown` and a Platform/Search AI Requests/Share/Pages Accessed/Unique Visitors table. Pages Accessed counts distinct non-empty requested paths. `—` means no privacy-safe visitor identifier was available for the selected data. With no rows, the Markdown includes a no-data notice.

**Example prompt:** “Which AI platforms are visiting my site most?”

### get_top_pages

Gets meaningful content pages ranked by canonical human and AI requests for one domain. It excludes monitoring, metadata, static assets, and malicious probe paths.

| Input | Type | Default | Description |
|---|---|---|---|
| `domain` | string | required | Domain to analyze |
| `range` | `7d` \| `30d` \| `90d` | `30d` | Time range |
| `limit` | integer | `10` | Pages to return; MCP accepts only whole numbers from `1` through `50` and rejects other values. The handler also defensively caps direct calls at `50`. |

**Output:** `# Top Pages` and a ranked Path/Visits table over canonical human and AI requests, or a no-data notice.

**Example prompt:** “What are the most visited monitored pages on example.com?”

### get_content_valuation

Estimates the monetary value of content accessed by AI platforms for one domain.

| Input | Type | Default | Description |
|---|---|---|---|
| `domain` | string | required | Domain to analyze |
| `range` | `7d` \| `30d` \| `90d` | `30d` | Time range |

**Output:** `# Content Valuation` with the detected vertical, base CPM, total estimated value, and total crawls. It includes `## By Platform` and `## By Content Type` tables, or a no-data notice when both are empty.

**Example prompt:** “What is the estimated value of AI-accessed content on example.com?”

### get_alerts

Gets recent AI citation alerts for the authenticated organization.

| Input | Type | Default | Description |
|---|---|---|---|
| `limit` | integer | `10` | Alerts to return; MCP accepts only whole numbers from `1` through `50` and rejects other values. The handler also defensively caps direct calls at `50`. |
| `scope` | `open` \| `all` | `open` | Return unacknowledged alerts only, or every alert |

**Output:** `# AI Alerts` followed by one Markdown bullet per alert with severity, type, platform, optional domain, status, and timestamp. It returns a no-alerts notice when empty.

**Example prompt:** “Show me my open AI citation alerts.”

### whatif_block_platform

Estimates the referral and value impact of blocking an AI platform for one domain.

| Input | Type | Default | Description |
|---|---|---|---|
| `domain` | string | required | Domain to analyze |
| `platform` | string | required | AI platform to simulate, for example `chatgpt` or `perplexity` |
| `range` | `7d` \| `30d` \| `90d` | `30d` | Time range |

**Output:** `# What-If: Block …` and a table of current crawls, referrals, projected referral loss, loss percent, and revenue impact, followed by a recommendation. With no platform data, it returns the corresponding safety message.

**Example prompt:** “What would happen if I blocked chatgpt from example.com?”

### get_weekly_trend

Gets a weekly traffic trend with AI/human totals and optional per-platform detail.

| Input | Type | Default | Description |
|---|---|---|---|
| `domain` | string | — | Optional domain filter |
| `range` | `30d` \| `90d` | `30d` | Time range |

**Output:** `# Weekly Traffic Trend` and a Week/Total/Human/AI/Other Automated/AI % table. Each weekly total reconciles across the three traffic classes. When platform data exists, it adds `## AI Visits by Platform` for up to eight named platforms; unknown AI traffic is omitted from that detail table.

**Example prompt:** “Show the weekly AI traffic trend for example.com over 90 days.”