← Updates

Public API and MCP 2.4: filters, annotations, share, and SEO enrich

Saved filters, report tags and notes, guest share links, and SEO metric refresh — in the REST API and MCP. 31 tools instead of 21, same API key.

The Public API and MCP server now support the full report workflow — what used to be web-app only. One Bearer key from Profile → Settings; the 60 requests per minute limit is shared by REST and MCP.

MCP now has 31 tools (was 21). A new Report workflow group — REST endpoints are grouped the same way: Reports, Account, Report workflow, Live checkers.

Saved filters

Save a search filter set by name and call it from a script or chat.

  • REST: GET / PUT / DELETE /v1/user/saved-filters
  • MCP: list_saved_filters, save_saved_filter, delete_saved_filter

Annotations and tags

Notes up to 200 characters and up to 10 tags per report — for shortlists, CRM, and team workflows.

  • REST: GET /v1/reports/annotations/tags, GET / PUT / DELETE /v1/reports/annotations
  • MCP: list_annotation_tags, get_report_annotation, set_report_annotation, delete_report_annotation

Guest share links

Send a report to a colleague or client without account access.

  • REST: POST /v1/reports/share → share_url in the response
  • MCP: create_share_link

The request body uses report_type and report_id from search or the full report.

SEO enrich via API

Loading missing SEO metrics is now available programmatically — outside the system queue, like on the report page.

  • REST: POST /v1/reports/{report_type}/{report_id}/enrich-seo (202 + job_id), then GET /v1/reports/enrich-jobs/{job_id} until status done
  • MCP: enrich_report_seo, get_enrich_report_seo_job

If MCP is already connected

You do not need to change the URL or key. The client caches the tool list for the session — open a new chat or restart Cursor / Claude / ChatGPT. New REST routes are available immediately.

Details, curl examples, and field schemas are on the updated API and MCP landing pages; the full schema is in Swagger UI.