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.