# Chat with your reports

Spyglasses reports are designed to be read by AI assistants as well as people.
There are two ways to put a report in front of your favorite assistant.

## 1. Chat with this report (instant)

On any unlocked AI Visibility report and any completed Site Readiness audit, the
**Share** panel includes a **Chat with this report** section. Pick an assistant
(ChatGPT, Claude, Perplexity, or Copilot) and it opens with a short prompt that
links to a Markdown version of the report. The assistant fetches that Markdown
and you can immediately ask it to summarize findings or suggest fixes.

You can also **Copy as Markdown** (to paste anywhere) or **View Markdown** (the
raw report text). Behind the scenes these use public Markdown endpoints:

- `…/api/reports-markdown/ai-visibility/<token>`
- `…/api/reports-markdown/site-audit/<token>` (links out to per-page detail)

This is a one-shot conversation — great for a quick read-through. For larger site
audits, the summary links to per-page Markdown the assistant can fetch as it
drills in.

## 2. Connect an assistant for live exploration (MCP)

For interactive, multi-turn analysis — drilling into individual pages, comparing
metrics, or working across *all* of your reports and account data — connect the
**Spyglasses MCP server** to your assistant.

The MCP server lives at `https://www.spyglasses.io/api/mcp` and exposes tools an
assistant can call on demand. It goes far beyond a single report: read any
report by its public token, list your organization's reports, chart historical
metrics, track message drift, score publishers and placements, and run the
citation optimizer — all from a plain-language conversation. The connector
authenticates with **OAuth**, so the first time you add it your assistant opens a
browser to sign in with your Spyglasses account (no API key).

**Quick setup:**

- **Claude Code:** install the Spyglasses plugin, which wires up the connector and
  a skill that teaches the assistant how to read the reports:

  ```
  /plugin marketplace add orchestra-code/spyglasses-skills
  /plugin install spyglasses@spyglasses-skills
  ```

- **Claude.ai / ChatGPT / other assistants:** add
  `https://www.spyglasses.io/api/mcp` as a custom MCP connector in your
  assistant's settings and complete the sign-in (OAuth) prompt.

<Callout>
This page covers the *instant, one-shot* way to chat with a report. For the full
picture — every tool, guided prompts, and connecting each assistant — see the
dedicated **[MCP Server documentation](/docs/mcp)** (start with
[Connecting the MCP server](/docs/mcp/setup)). Note the "Chat with this report"
buttons cannot connect an MCP for you: connectors are added once, manually, in
your assistant's settings.
</Callout>