X (Twitter) Trends API

ai.trendsapiPublished by trendsapi.aiOfficial publisherv1.0.2Updated Oct 24, 2026

X trending topics and discussion volume over time. Free key at trendsapi.ai

The publisher's own server: Amazon Trends API

VerifiedStreamable HTTPWeb executableWeb Search & Scraping Data & Analytics

Server details

Identifier: ai.trendsapi/x-twitter
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to trendsapi.ai, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/ai.trendsapi%2Fx-twitter.svg)](https://sourceweft.com/mcp/ai.trendsapi%2Fx-twitter?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Remote MCP server that gives an assistant live X (Twitter) trending boards, hashtag top posts, and keyword trend growth and history.

What you can do: Fetch live top-trending boards for one feed type, with category selection and sorting by current rank or rank change
Get live top posts for a single hashtag on one social source, fetched fresh on each call
Get point-to-point growth for a keyword across one or more sources over preset windows such as 12M, 3M or YTD
Get a full historical time series for one keyword and one source, for charting or custom math
Check plan, requests used this month, requests left and reset time
When to use it: Useful when you want an assistant to answer questions about what is trending on X and other social sources, how a keyword's discussion volume has grown, or which posts are performing on a given hashtag, without building your own data pipeline.
Requirements: A remote streamable HTTP endpoint; no local package. A bearer token sent in the Authorization header is required, and a free API key is available from the provider. Requests are subject to plan limits and a monthly quota.

Before you install

The Authorization bearer token is a secret and must be kept private. Usage counts against a monthly request quota, and calls return plan-limit messages when rate limited or over quota; check usage before heavy querying. Trend data is fetched live from third-party sources on each call.

Installation

In SourceWeft

Open X (Twitter) Trends API in the dashboard and add it to a workspace.
Connect Authorization token credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.trendsapi%2Fx-twitter/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "x-twitter-trends-api": {
      "type": "http",
      "url": "https://x-twitter.api.trendsapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

This repository has no README.

Tools

trends___get_growth

Get Growth

Point-to-point growth for a keyword on one or more sources. Each window is a preset string (12M, 3M, YTD, and the other listed periods). Values are on a 0-100 scale, plus absolute volume when available. Designed for growth questions; for charting or custom math, get_time_series provides the full series. app downloads and app rankings are keyword sources (Android bundle ID). They are not the App Store / Google Play live boards on get_top_trends. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.

Parameterssourcerequiredkeywordrequiredpercent_growth

trends___get_time_series

Get Time Series

Full historical series for one keyword and one source (0-100 values, plus volume when available). Suited for charting or custom math. Live 'what's trending now' boards are on get_top_trends. get_growth answers most growth questions with less data. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.

Parameterssourcerequiredkeywordrequired

trends___get_top_posts

Get Top Posts

Live top posts for one hashtag on one social source. Fetched live on every call; nothing is stored. For when the user already has a hashtag and wants the posts winning on it. get_top_trends ranks the hashtags themselves. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.

Parameterslimitsourcerequiredkeywordrequired

trends___get_top_trends

Get Top Trends

Live top-trending board for exactly one feed type. No keyword. For 'Amazon Best Sellers by Category', 'Google Trends by Category', 'Top Websites', 'Substack by Category', and 'TikTok Trending Hashtags by Category', category selects the board. Default sort is current rank. Use sort='rank_change' for climbers vs a prior snapshot (window 1d, 3d, 7d, 14d, or 30d). If the requested board is not in the database yet (for example a country that is not collected on the schedule), the board is fetched live. App Store Top Free, App Store Top Paid, and Google Play are live store boards, not keyword lookups. App history is available via get_growth or get_time_series with source app downloads or app rankings and an Android bundle ID. Live boards are only available here, not via get_time_series. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.

Parameterssorttyperequiredlimitoffsetwindowcountrycategory

trends___get_usage

Get Usage

Shows your plan, requests used this month, requests left, and when it resets. Free: does not use a request. Call it when the user asks about their limit or after a limit error. Need more? https://www.trendsmcp.ai/account#account

Takes no parameters.

Version history

v1.0.2LatestOct 21, 2026
v1.0.1Sep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.
License10 pts
Declare a license in the repository or the registry entry.