Developer documentation · MCP

Use Reflyma from your AI assistant.

Connect Reflyma through Model Context Protocol (MCP) and let a compatible AI client securely query your projects, run supported SEO and AI visibility scans, compare persisted reports, and retrieve results.

What is Reflyma MCP?

MCP lets compatible AI clients call Reflyma's exposed tools through an authenticated connection. Read tools retrieve persisted SEO data; scan tools can start a real website crawl, run technical SEO audits, and initiate AI visibility reports using the existing Reflyma workers. Poll status tools for progress, retrieve detailed results, and compare reports. Free/Pro/Agency/Enterprise limits apply server-side. Monthly MCP quotas are 5 scans per type for Free, 100 for Pro, 300 for Agency, and 1,000 for Enterprise per organization. Completed AI visibility reports can be exported to PDF/CSV; signed download links expire. Reflyma provides scan data and recommendations; it does not edit or fix your website.

Connect step by step

1

Open Reflyma MCP

Visit reflyma.com/mcp to start the Reflyma MCP connection flow.

2

Connect a compatible AI client

In your MCP-compatible AI assistant, add Reflyma and start the authorization flow.

3

Authorize your Reflyma account

Sign in with the Reflyma account that can access the projects you want to query.

4

List your projects first

Ask the assistant to list your Reflyma projects. The returned project ID is used by project-level tools.

5

Ask for a report or score

For example: “Start a website crawl for my Reflyma project.” The assistant receives a crawl ID, then repeatedly polls its status; each poll advances one step of the existing crawler even when no dashboard is open. After the crawl completes, ask it to run a technical SEO audit.

6

Review the result

Use returned persisted scores, issue counts, crawl progress and audit results. A crawl runs through Reflyma’s worker; the technical SEO audit runs inline after a completed crawl is available.

Available MCP tools

List projects

list_projects

Find projects available to your authenticated Reflyma account.

Technical SEO score

get_technical_score

Return the latest technical SEO score and issue counts for a project.

Start website crawl

start_website_crawl

Queue a real crawl through Reflyma’s existing crawler; returns a crawl ID.

Crawl status

get_crawl_status

Advance one crawl-engine step and return persisted stage, URL/page counters and status; repeat polling until terminal.

Cancel website crawl

cancel_website_crawl

Cancel an active crawl; requires project manager permissions.

Run technical SEO audit

start_seo_audit

Run the existing technical analyzer on the latest completed crawl; this operation runs inline.

SEO audit status

get_seo_audit_status

Retrieve persisted status and summary for an audit ID.

SEO audit history

get_seo_audit_history

List persisted audits with status, scores, issue totals and pagination.

SEO audit results

get_seo_audit_results

Retrieve a selected audit and its technical-health score breakdown.

Compare SEO audits

compare_seo_audits

Compare two completed audits, score/severity deltas, and new/resolved/continuing issues.

SEO issues

get_seo_issues

Filter persisted findings by severity, status, audit or URL; includes recommended fixes.

SEO issue evidence

get_seo_issue_evidence

Retrieve persisted HTML/HTTP/URL/metric evidence for an authorized issue.

Crawl summary

get_crawl_summary

List recent crawl snapshots and their progress/page counts.

Crawl errors

get_crawl_errors

Retrieve persisted HTTP/crawl errors for a selected or latest snapshot.

Internal links

get_internal_links

List internal links discovered by a crawl, with pagination.

Redirect chains

get_redirect_chains

Retrieve redirect hops discovered by a crawl.

AI visibility

get_ai_visibility

Return the latest AI search visibility report when one exists.

Start AI visibility scan

start_ai_visibility_scan

Run real prompt/provider checks using the project's configured AI providers; plan limits apply and large runs require confirmation.

AI visibility scan status

get_ai_visibility_status

Poll persisted report status and provider/prompt progress.

AI visibility report

get_ai_visibility_report

Retrieve persisted metrics and paginated provider/prompt results.

Compare AI visibility reports

compare_ai_visibility_reports

Compare stored metrics across two report runs for the same project.

Create report file

create_ai_visibility_report_export

Generate a PDF or CSV from a completed AI visibility report and return a secure expiring download URL.

List report files

list_ai_visibility_report_exports

List stored PDF/CSV export metadata for an authorized report.

Get report download link

get_ai_visibility_report_export_url

Create a fresh short-lived signed URL for a stored export.

Monthly scan usage

get_mcp_scan_usage

Show current organization usage, remaining quota and monthly reset date.

Reports

get_reports

List recent report runs and their status for a project.

Analyze robots.txt

analyze_robots_txt

Fetch a site's robots.txt and report supported AI crawler access.

Example prompts

“List my Reflyma projects.”
“Start a website crawl for my project and give me the crawl ID.”
“Poll crawl status for crawl ID <crawl_id> until it completes.”
“Run a technical SEO audit on my latest completed crawl and summarize the critical issues.”
“Show the latest SEO audit history and score for my project.”
“Run a fresh crawl and technical SEO audit, then compare it with my previous completed audit.”
“List all critical SEO issues and their recommended fixes.”
“Show crawl errors and internal links for my latest crawl.”
“Start an AI visibility scan for my project and tell me the report ID.”
“Check AI visibility report <report_run_id> until it finishes, then summarize the results.”
“Compare AI visibility report <older_report_run_id> with <newer_report_run_id>.”
“Generate a PDF and CSV for my latest completed AI visibility report and give me download links.”
“List files for report <report_run_id> and create a fresh download link for the CSV.”
“How many SEO and AI visibility scans do I have left this month?”
“Show my latest AI visibility report.”
“List my recent Reflyma reports.”
“Analyze robots.txt for https://example.com and tell me which AI crawlers are blocked.”

Security

MCP access is authenticated. Review the AI client you connect, never share passwords or OAuth tokens in prompts, and disconnect an integration you no longer trust.