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.