MIT-LICENSED AGENT TOOLING

Open-source agent tooling.
Hosted trend intelligence.

TrendsFast’s agent kit is open source under the MIT license: an agent skill, a CLI, a plugin and an n8n community node. You can inspect, modify and redistribute that code under its license. The kit connects Claude Code, Cursor, Grok Bot, OpenClaw, skills.sh agents and n8n to the hosted service. The research engine and cloud application remain private.

TRENDS API / V3 / PUBLIC AGENT TOOLING

Connect once. Ask what is trending.

Account → scoped key → MCP or REST → one bounded query → free rereads.

  1. Create your free account. A verified account receives 100 free credits once, then 50 every month. Global questions need no brand context; adding your brand lets niche queries rank evidence against it.
  2. Create a key in API keys. It is shown once and is scoped to one workspace with trends:query, trends:read and credits:read. Keep it in TRENDSFAST_API_KEY in your client’s environment, never in chat, URLs or command arguments.
  3. Add the remote MCP server https://trendsfast.com/api/mcp/v3 with that key as a bearer token, or call REST under /v3/trends. Both share one service, one set of scopes and one credit balance.
  4. Ask one bounded question. Every query carries a request_id UUID you keep and a max_credits ceiling. A Global query costs at most 1 credit, Niche 3 credits, Ask 5 credits. Empty results cost nothing.
  5. Reread the saved result free until its expires_at: up to 30 days, sooner when a source’s terms end it. Reads, pagination and recovering a lost response by its request_id cost 0 credits and never start new research. After it, a read answers RESULT_EXPIRED; the query runs again under a new request_id, at its price.
The authenticated MCP tools
ToolCostWhat it does
trendsfast_discover_trends5 creditsOne question across global, core and adjacent scope and every channel.
trendsfast_global_trends1 creditWhat is trending across the shared index. No brand context needed.
trendsfast_niche_trends35 creditsTrends ranked against your niche. Name a product to collect your brand's sources fresh first.
trendsfast_ask_trends5 creditsOne bounded question, answered from saved evidence.
trendsfast_video_outlier5 creditsOne TikTok, Instagram or YouTube video against its creator's recent posts. Charged only when found.
trendsfast_read_resultfreeReread or page through a saved result, or recover a lost response.
trendsfast_community_brieffreeRead before drafting for a subreddit, free: its people, how to sound, the winning post and reply, its rules.
trendsfast_project_contextfreeThe connected brand and its confirmed niche context.
trendsfast_credit_balancefreeThe credit balance shared by the dashboard, REST and MCP.
What does my agent receive?
Trends with their evidence: the original source URL, publication and observation dates, the signal, any measured growth, the platform, and what coverage was and was not available. Ask answers also show how the question was interpreted. Your agent decides what to write or build with it.
Which sources are behind it?
Search, AI search, community and video sources, each with its own status on the sources page. A channel with no permitted observation is reported as unavailable, not as an empty trend list, so “nothing is trending” and “we cannot see there” never look the same.
Which clients work?
Any client that speaks Streamable HTTP MCP with a bearer token. Claude, ChatGPT, Grok, Grok Bot, Claude Code, Cursor and VS Code can connect with OAuth instead of a key. See agent setup for each client’s exact command.
What happens after a lost response?
Keep the same request_id and read /v3/trends/requests/{request_id} once before deciding anything. A missing response does not mean nothing was debited, and a new identity is a new billable query.
Existing v1 and v2 integrations
/v1, /api/mcp and the Marketing v2 MCP at /api/mcp/v2 are still served for clients built on them, with their own keys and contracts. New connections use V3. See the v1 OpenAPI.
What stays under your control?
Every query is explicit and capped by your max_credits. TrendsFast never posts, schedules or publishes anything; it returns evidence, and you or your agent decide what to do with it.
V3 MCP connection
TRENDSFAST_API_KEY=<your key>   # set in the client's environment
MCP server: https://trendsfast.com/api/mcp/v3

See agent setup, the API reference, Docs and the V3 OpenAPI.

What is public today

Read the MIT license and reviewed source before installing. The open-source license covers this public package; access to hosted research follows your TrendsFast plan and project permissions.

  • The trendsfast agent skill and its REST reference, for Claude Code, Codex, OpenClaw and any agent that loads skills.
  • A plugin for Claude Code, Cursor and Grok Bot that adds the hosted MCP server with an MCP-only skill. You sign in through your browser, so it holds no key.
  • An n8n community node for the five products and the free reads, on npm as n8n-nodes-trendsfast. n8n has not verified it yet, so self-hosted n8n installs it as a community node.
  • The trendsfast CLI, on npm as trendsfast-cli, which installs the skill into each coding agent and signs in through the browser.
  • The earlier v1 installer, kept for the installations already using it.

What it is not

trendsfast-open is not the private TrendsFast decision engine, a copy of the managed cloud, or a supported self-hosting distribution. It contains no private provider adapters, routing, scoring, prompts, economics, operations, entitlements, customer data, or managed credentials.

The three repository planes

  • trendsfast-cloud: the active private product source of truth.
  • meestierolff/trendsfast: a frozen historical public implementation; it receives no new private implementation or redesign work.
  • trendsfast-open: the public agent kit, and the pinned v1 installer that existing installations still use.

Install the agent kit

In Claude Code, add the plugin. You sign in through your browser, so there is no key to paste:

Claude Code plugin install commands
/plugin marketplace add meestierolff/trendsfast-open
/plugin install trendsfast@trendsfast

For any agent that loads skills, or OpenClaw, install the skill and keep the key in TRENDSFAST_API_KEY:

Agent skill install command
npx skills add meestierolff/trendsfast-open --skill trendsfast
OpenClaw skill install command
clawhub install trendsfast

For every coding agent on your computer at once, install the CLI, which signs in through your browser, then check the setup for free:

TrendsFast CLI install command
npx -y trendsfast-cli@latest init
TrendsFast CLI check command
npx -y trendsfast-cli@latest doctor

Claude, ChatGPT, Grok, Grok Bot, Claude Code, Cursor and VS Code need no key: they sign in with your TrendsFast account. See the agent setup for each.

See the agent setup for every way to connect, or read the canonical REST contract.

Open the repository on GitHub →