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.
- 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.
- Create a key in API keys. It is shown once and is scoped to one workspace with
trends:query,trends:readandcredits:read. Keep it inTRENDSFAST_API_KEYin your client’s environment, never in chat, URLs or command arguments. - Add the remote MCP server
https://trendsfast.com/api/mcp/v3with that key as a bearer token, or call REST under/v3/trends. Both share one service, one set of scopes and one credit balance. - Ask one bounded question. Every query carries a
request_idUUID you keep and amax_creditsceiling. A Global query costs at most 1 credit, Niche 3 credits, Ask 5 credits. Empty results cost nothing. - 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 itsrequest_idcost 0 credits and never start new research. After it, a read answersRESULT_EXPIRED; the query runs again under a newrequest_id, at its price.
| Tool | Cost | What it does |
|---|---|---|
trendsfast_discover_trends | 5 credits | One question across global, core and adjacent scope and every channel. |
trendsfast_global_trends | 1 credit | What is trending across the shared index. No brand context needed. |
trendsfast_niche_trends | 35 credits | Trends ranked against your niche. Name a product to collect your brand's sources fresh first. |
trendsfast_ask_trends | 5 credits | One bounded question, answered from saved evidence. |
trendsfast_video_outlier | 5 credits | One TikTok, Instagram or YouTube video against its creator's recent posts. Charged only when found. |
trendsfast_read_result | free | Reread or page through a saved result, or recover a lost response. |
trendsfast_community_brief | free | Read before drafting for a subreddit, free: its people, how to sound, the winning post and reply, its rules. |
trendsfast_project_context | free | The connected brand and its confirmed niche context. |
trendsfast_credit_balance | free | The 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_idand 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/mcpand the Marketing v2 MCP at/api/mcp/v2are 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.
TRENDSFAST_API_KEY=<your key> # set in the client's environment
MCP server: https://trendsfast.com/api/mcp/v3See 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
trendsfastagent 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
trendsfastCLI, on npm astrendsfast-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:
/plugin marketplace add meestierolff/trendsfast-open
/plugin install trendsfast@trendsfastFor any agent that loads skills, or OpenClaw, install the skill and keep the key in TRENDSFAST_API_KEY:
npx skills add meestierolff/trendsfast-open --skill trendsfastclawhub install trendsfastFor every coding agent on your computer at once, install the CLI, which signs in through your browser, then check the setup for free:
npx -y trendsfast-cli@latest initnpx -y trendsfast-cli@latest doctorClaude, 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.