> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.writesonic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect Writesonic's AI search visibility data directly to Claude and other MCP-compatible AI assistants.

## Overview

The Writesonic MCP (Model Context Protocol) server lets you query your GEO analytics data directly from Claude conversations. Ask questions about brand visibility, citations, sentiment, and competitor performance across 10+ AI platforms — all without leaving your AI assistant.

**Server URL:**

```
https://mcp.writesonic.com/mcp
```

## What You Can Do

* **Track brand visibility** across ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews, and more
* **Analyze citations** — see where and how often AI platforms reference your brand
* **Monitor sentiment** — understand how AI models describe your brand
* **Compare against competitors** — benchmark share of voice, citation share, and visibility scores
* **Explore prompts** — discover which search queries mention your brand
* **Slice data by dimensions** — market, model, topic, date, website, and more

## Connection Methods

| Platform           | How to Connect                                                                         |
| ------------------ | -------------------------------------------------------------------------------------- |
| **Claude.ai**      | Settings > MCP Servers > Add `https://mcp.writesonic.com/mcp`                          |
| **Claude Desktop** | Add to `claude_desktop_config.json` (see [Setup Guide](/mcp/setup))                    |
| **Claude Code**    | `claude mcp add writesonic --transport streamable-http https://mcp.writesonic.com/mcp` |

## How It Works

1. **Connect** — Add the Writesonic MCP server URL to your Claude client
2. **Authenticate** — Sign in with your Writesonic account via OAuth when prompted
3. **Query** — Ask Claude about your GEO data in natural language

### Example Conversation

> **You:** Show me my brand's visibility score trend over the last 3 months, broken down by AI platform.
>
> **Claude:** Let me pull that data from Writesonic. I'll query the performance report grouped by model and date...
>
> *Claude calls `get_all_projects`, then `query_performance_report` with dimensions `["model", "date"]`*

## Requirements

* A Writesonic account with any active **paid plan**
* At least one project with tracked prompts configured in your [Writesonic dashboard](https://app.writesonic.com)

## Available Tools

The MCP server exposes 87 tools spanning data fetching, aggregated reports, prompt analytics, citation analytics, actionable opportunities, and project management. See the [Tools Reference](/mcp/tools-reference) for full details. The core tools to know:

| Tool                        | Description                                              |
| --------------------------- | -------------------------------------------------------- |
| `get_all_projects`          | List all accessible projects (call this first)           |
| `get_all_prompts`           | Browse tracked search queries with visibility scores     |
| `get_all_topics`            | Get topic categories grouping related prompts            |
| `get_all_tags`              | Get custom tag labels for filtering                      |
| `get_all_citations`         | Get individual citation URLs                             |
| `get_all_websites`          | Get tracked websites (brand + competitors)               |
| `get_all_keywords`          | Get keywords found in AI responses                       |
| `get_all_models`            | Get tracked AI platforms                                 |
| `get_all_markets`           | Get tracked geographic markets                           |
| `get_all_domains`           | Get citing domains (aggregated by domain)                |
| `query_performance_report`  | Aggregated visibility and share of voice metrics         |
| `query_citation_report`     | Aggregated citation counts and domain analysis           |
| `query_sentiment_report`    | Sentiment analysis and keyword occurrence metrics        |
| `get_kpi_summary`           | Single-call KPI dashboard with period-over-period deltas |
| `get_actionables_dashboard` | Summary of all actionable recommendations                |
| `tools_info`                | Get a ready-made execution plan for a complex question   |

## Next Steps

<CardGroup cols={2}>
  <Card title="Setup Guide" icon="gear" href="/mcp/setup">
    Platform-specific setup instructions
  </Card>

  <Card title="Tools Reference" icon="wrench" href="/mcp/tools-reference">
    Detailed tool parameters and responses
  </Card>

  <Card title="Use Cases & Examples" icon="lightbulb" href="/mcp/examples">
    Real-world prompts and workflows
  </Card>

  <Card title="GEO API Reference" icon="code" href="/api-reference">
    REST API documentation
  </Card>
</CardGroup>