Integration docs

POP FX is a stateless visual-effects service for AI clients. The preferred integration is remote MCP over Streamable HTTP. A REST/OpenAPI compatibility surface is also available.

Endpoints

https://pop-fx-mcp.loxihart.com/mcp — remote MCP
https://pop-fx-mcp.loxihart.com/openapi.json — OpenAPI 3.1
https://pop-fx-mcp.loxihart.com/v1/effect — REST fallback
https://pop-fx-mcp.loxihart.com/healthz and https://pop-fx-mcp.loxihart.com/readyz — health/readiness

Authentication

None in v1. Tools are read-only, stateless, and do not mutate external systems.

MCP protocols

Supported: 2026-07-28, 2025-11-25, 2025-06-18, and 2025-03-26.

Tools

• apply_effect — apply a named effect to text.
• surprise_me — choose a treatment from the content.
• create_reveal — generate a staged reveal.
• list_effects — enumerate production presets.
• quality_check — validate an EffectSpec against the EOTA Studio v1 structural gate.

Limits

Maximum request body: 32 KB. User text: 2,000 characters. Effect intensity: 1–5. Compute endpoints are protected by Cloudflare Rate Limiting at 240 calls per 60 seconds per source key per Cloudflare location. Rate limiting is intentionally protective rather than billing-grade accounting.

Tool classification

All current tools are Read / non-destructive / idempotent / closed-world. They generate declarative EffectSpecs and render links; they perform no writes to customer systems.