Changelog

Every /api/v1 and /api/mcp response carries X-MF-API-Version. It holds 2026-08-23, the date of the top entry here. Under the contract freeze every change is additive, so you never need to pin it.

Step four: tone, with receipts

2026-08-23.

• GET /api/v1/sentiment and the MCP tool get_sentiment: how the engines talk about you and every tracked rival. A 0 to 100 index per brand and per engine, the raw positive, neutral and negative counts behind it, and the verbatim quotes the tone was read from, worst first. Same window grammar as metrics history. See Resources.
• Answer rows on both surfaces now carry evidence on each mention, the span the tone came from.

Step three: locked down

2026-07-24.

• Keys can expire, take an IP allowlist, and rotate with a 24-hour overlap. Webhooks sign with your own secret. See API keys and Webhooks.
• New reads: ads, fact check, tag groups. All of them on MCP too. See Resources.

Step two: your own keys

2026-07-08 to 07-12.

• Workspace keys (mf_…), an ingest-only scope for Workers, 120 requests a minute, cursor pagination. See Limits.
• Crawler ingest got its own 120-a-minute bucket, separate from the read one, so a shipper and a dashboard on the same key cannot starve each other.
• New reads: urls, crawler analytics, metrics history, shopping.

Step one: the API

2026-07-04 to 07-05.

• Read-only v1 REST: overview, prompts, competitors, sources, answers, brands. The response fields froze here.
• The MCP server at /api/mcp, the same views as tools. Crawler ingest opened, unmetered.