v3.0.0

This release has breaking changes.

Changed

• BREAKING: recency has no default. It used to default to month, so every query was nudged toward the last month; omit it now for no time limit. It is sent as Perplexity's search_recency_filter instead of a hint in the system prompt, accepts hour, day, week, month, year, and rejects other values
• BREAKING: sources and images are appended to the text content (a numbered Sources: list from the top-level search_results, falling back to the deprecated citations, and an Images: list when return_images is set) instead of being returned under meta
• return_citations is no longer sent to the API (Perplexity always returns sources); it controls whether the Sources: list is appended
• The publish workflow installs npm 11.21.0 instead of npm@latest, so a release never runs an npm version that came out the same day

Removed

• BREAKING: the meta field of the tool result, including meta.model and meta.usage, which clients did receive. Its citations and images were read from choices[0].message, where Perplexity does not put them, so they were always empty
• BREAKING: the stream parameter. The server parsed the reply as one JSON body, so stream: true made the API return server-sent events and the call failed; an MCP tool result is returned whole anyway. stream is never sent to the API

Fixed

• A response without choices[0].message.content gives a clear error instead of a TypeError
• The publish workflow runs when a release is published, not when it is created, so a release saved as a draft first still publishes to npm

Added

• Requests to the Perplexity API send an X-Pplx-Integration: perplexity-mcp header so Perplexity can attribute traffic to this server
• Tests (npm test, node --test) for the request builder, the response formatter and the tool schema over stdio, run in CI after the build

Install: npx -y @jschuller/perplexity-mcp@3.0.0. Published from GitHub Actions with npm provenance.