# 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 — connect the **Spyglasses MCP
server** to your assistant.

The MCP server lives at `https://www.spyglasses.io/api/mcp` and exposes tools to
fetch report data on demand:

- `get_ai_visibility_report`, `get_site_audit_summary`, `list_site_audit_pages`,
  `get_site_audit_page` — scoped to a single report by its public token.
- `list_my_organizations` / `list_reports` — list your organizations and their
  reports, using your signed-in Spyglasses account.

The connector authenticates with **OAuth**: the first time you add it, your
assistant opens a browser to sign in with your Spyglasses account.

### 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>
The "Chat with this report" buttons cannot connect an MCP for you — assistant
connectors are added once, manually, in your assistant's settings. The buttons
are for instant one-shot chats; the MCP is for ongoing, interactive analysis.
</Callout>