REMOTE MCP / V1
Connect an MCP client to one project-scoped interface for confirmed context, an explicit Today request, immutable briefs and creative handoffs, and honest source status.
Install the agent skillGet project accessRead the connection contract
STATELESS STREAMABLE HTTP
https://trendsfast.com/api/mcp
Contract trendsfast-remote-mcp-v1. Protocol 2026-07-28. Direct project-scoped bearer authentication. Read scope next_move:read; write scope next_move:write. Tools only; no sessions, subscriptions, publishing, or scheduling.
AGENT INSTALLER / REVIEWED GITHUB RELEASE
The installer adds the public TrendsFast skill and a local stdio bridge to the live Remote MCP server. It contains no private research, routing, scoring, prompts, or provider logic.
PRIMARY INSTALL / IMMUTABLE SOURCE
npx -y github:meestierolff/trendsfast-open#9e7053b47eebfbfdc6ce003edaf7d10b849afc55 installRequires Node.js 22 or newer. The command is pinned to the accepted public merge; there is no floating branch or unreviewed package alias.
PACKAGE
Version 0.1.0-alpha.0
Binary trendsfast
PUBLICATION
npm status: npm deferred. Use only the reviewed GitHub command above for this release.
CREDENTIAL MODE / ENVIRONMENT ONLY
Export the project-scoped key in the environment before installation. Never place the raw key in argv or client configuration; let the managed MCP process inherit it.
TESTED CLIENTS / EXACT LABELS
Choose one or more clients in the interactive installer. Other clients must use the generic stdio contract and are not represented as native integrations.
SUPPORTED CLIENT
For any MCP client that can launch a local stdio command.
Installer selector: --client generic
SUPPORTED CLIENT
A tested managed MCP entry and installed TrendsFast skill.
Installer selector: --client claude-code
SUPPORTED CLIENT
A tested managed MCP entry and installed TrendsFast skill.
Installer selector: --client codex
VERIFY / ZERO SCAN
Doctor and the default demo are read-only. Neither command creates a scan, invokes a provider or model, reserves cost, approves, delivers, publishes, or schedules.
DOCTOR / READ-ONLY
npx -y github:meestierolff/trendsfast-open#9e7053b47eebfbfdc6ce003edaf7d10b849afc55 doctor --jsonJSON output reports local configuration, credential availability, contract drift, live source status, and read-only connection health with zero scans created.
DEFAULT DEMO / READ-ONLY
npx -y github:meestierolff/trendsfast-open#9e7053b47eebfbfdc6ce003edaf7d10b849afc55 demoThe default demo reads confirmed project context and the latest existing immutable brief. It creates zero scans and causes zero provider, model, or cost effects.
CREATE TEMPLATE / EFFECT-BEARING
npx -y github:meestierolff/trendsfast-open#9e7053b47eebfbfdc6ce003edaf7d10b849afc55 demo --create --idempotency-key <uuid-v4> --objective <text> --capability <name>Template only: replace every angle-bracket field and quote multi-word values before running. Do not paste the template unchanged.
Create requires the explicit --create flag, a caller-created UUID v4 idempotency key, the objective, at least one confirmed content capability, and interactive confirmation.
One confirmed run makes exactly one scan admission. That scan may call configured providers and models and may incur bounded cost. It never approves, delivers, publishes, or schedules the result, and it never retries an ambiguous create.
RECOVERY / NO SECRET COPYING
Start with Doctor. If the managed files drift, remove only the installer-owned entries and reinstall from the same reviewed source.
Node is too old
Install Node.js 22 or newer, then rerun the primary install command.
Key is missing or revoked
Set an active project-scoped key in TRENDSFAST_API_KEY. Never put the key in argv or client configuration.
Install is missing
Run the primary install command above, then run Doctor again.
Managed configuration drift
Do not hand-edit the managed entry. Uninstall it, rerun the reviewed installer, then verify with Doctor.
Client is unsupported
Use Generic stdio MCP, or switch to the tested Claude Code or Codex integrations.
A clean reinstall is needed
Run the immutable uninstall command below, rerun the primary install command, and finish with Doctor.
MANAGED UNINSTALL
npx -y github:meestierolff/trendsfast-open#9e7053b47eebfbfdc6ce003edaf7d10b849afc55 uninstallUninstall preserves unrelated client entries. Rerun the primary install command above, then finish with Doctor. Replace a missing or revoked key only through the TRENDSFAST_API_KEY environment variable.
CONNECTION CONTRACT
Access is feature-gated. Use an active project-scoped key and keep it in the Authorization header; never place credentials in a URL or persist them in an MCP session.
POST https://trendsfast.com/api/mcp
Authorization: Bearer <project-scoped-api-key>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2026-07-28
Mcp-Method: server/discoverAUTHENTICATION
Tool arguments never grant project access. Every resource handle is checked again against the authenticated project on every call.
CLIENT ACCEPT
V1 returns one JSON response, while clients advertise both required media types for Streamable HTTP compatibility.
TOOLS / EXACT ORDER
Read tools create no scan, provider call, model call, reservation, approval, delivery, publication, or scheduling event.
| Tool | Scope | Effect | What it returns |
|---|---|---|---|
| trendsfast_project_context_get | next_move:read | ZERO-EFFECT READ | Return only the authenticated project's current public-safe confirmed context. |
| trendsfast_today_create | next_move:write | BOUNDED WRITE | Admit one user-intended Today’s Trend Brief request with the caller's exact UUID v4 idempotency key; never approve, deliver, publish, schedule, or poll automatically. |
| trendsfast_today_status_get | next_move:read | ZERO-EFFECT READ | Read the public-safe lifecycle of a known scan owned by the authenticated project. |
| trendsfast_brief_latest_get | next_move:read | ZERO-EFFECT READ | Return the latest immutable V1 or V2 brief for the authenticated project's current confirmed context. |
| trendsfast_brief_get | next_move:read | ZERO-EFFECT READ | Return one exact immutable V1 or V2 brief by public brief ID after project ownership is rechecked. |
| trendsfast_creative_handoff_get | next_move:read | ZERO-EFFECT READ | Return the exact immutable public-safe ShipToUsers creative handoff without calling ShipToUsers, uploading media, creating a generation job, or regenerating content. |
| trendsfast_sources_get | next_move:read | ZERO-EFFECT READ | Return only the current bounded public source-status projection, including limitations and verification truth. |
TWO EXPLICIT FLOWS
MCP returns public-safe projections from existing TrendsFast services. It never reads raw provider payloads or turns a handoff into a ShipToUsers network call.
READ-ONLY WORKFLOW / next_move:read
These calls create no scan, provider or model call, cost reservation, approval, delivery, publication, or scheduling event.
CREATE WORKFLOW / next_move:write
The server creates no hidden retry key, performs no automatic polling, and never bypasses founder review or auto-publishes the result.
OPERATING RULES
Briefs retain their source status, observed evidence, limitations, and honest NO CLEAR TREND semantics. Unsupported momentum is never invented.
Today creation requires the exact intent, current confirmed capabilities, and a caller-created UUID v4 idempotency key. The server never creates a hidden retry.
TrendsFast recommends. It does not approve, deliver, publish, schedule, manage keys, mutate projects, or expose raw provider data through MCP.
Request a project keyRead the REST API docsCheck source status