protogrid

Search / ai.trendsmcp/x-twitter

X (Twitter) Trends MCP

R1· needs a key

Twitter (X) trends over time, with growth for any keyword. Free key at trendsmcp.ai

v1.0.6 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds X_TWITTER_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality91strong
Trust89of 100
Uptime, 30 days100%
Latency p50335 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "x-twitter": {
      "type": "http",
      "url": "https://x-twitter.api.trendsmcp.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${X_TWITTER_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http x-twitter https://x-twitter.api.trendsmcp.ai/mcp --header "Authorization: Bearer ${X_TWITTER_TOKEN}"
[mcp_servers.x-twitter]
url = "https://x-twitter.api.trendsmcp.ai/mcp"
bearer_token_env_var = "X_TWITTER_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "x-twitter": {
      "type": "remote",
      "url": "https://x-twitter.api.trendsmcp.ai/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:X_TWITTER_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "x-twitter": {
      "type": "http",
      "url": "https://x-twitter.api.trendsmcp.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${X_TWITTER_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=x-twitter&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8veC10d2l0dGVyLmFwaS50cmVuZHNtY3AuYWkvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7WF9UV0lUVEVSX1RPS0VOfSJ9fQ%3D%3D"
}
{
  "servers": {
    "x-twitter": {
      "type": "http",
      "url": "https://x-twitter.api.trendsmcp.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${X_TWITTER_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "x-twitter": {
      "httpUrl": "https://x-twitter.api.trendsmcp.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${X_TWITTER_TOKEN}"
      }
    }
  }
}
extensions:
  "x-twitter":
    enabled: true
    name: "x-twitter"
    type: streamable_http
    uri: "https://x-twitter.api.trendsmcp.ai/mcp"
    headers:
      "Authorization": "Bearer ${X_TWITTER_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${X_TWITTER_TOKEN}. The registry never accepts secret values.

Quality 91 / 100strong

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-03-26; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations4 of 4 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 2,032 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

4 tools, about 2,032 tokens to load them all · tool set 1a6d3750e30c · checked 2026-10-19 10:52 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 89 / 100

duplicate-repo
provenance85
liveness100
freshness85
hygiene80

+repository +dns-namespace +website +reachable +uptime-100% ~updated-62d-ago -duplicate-repo(10 names)

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://x-twitter.api.trendsmcp.ai/mcp streamable-httpapi_key ${X_TWITTER_TOKEN}yes100%335 ms2025-03-262026-10-19

Tools (4)

trends___get_growthread-onlyPoint-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.
trends___get_time_seriesread-onlyFull 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.
trends___get_top_postsread-onlyLive 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.
trends___get_top_trendsread-onlyLive 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.

Schemas: list_tools.

Also listed as

9 other active names share this repository: ai.trendsmcp/competitor-tracking, ai.trendsmcp/content-strategy, ai.trendsmcp/crypto, ai.trendsmcp/ecommerce, ai.trendsmcp/market-research, ai.trendsmcp/seo, ai.trendsmcp/social-media, ai.trendsmcp/spotify, ai.trendsmcp/trends

Similar MCP servers

More from ai.trendsmcp

And 14 more from this publisher.

Official server.json
{
  "name": "ai.trendsmcp/x-twitter",
  "icons": [
    {
      "src": "https://www.trendsmcp.ai/static/pages/trendsmcp/assets/trend.svg",
      "sizes": [
        "any"
      ],
      "mimeType": "image/svg+xml"
    }
  ],
  "title": "X (Twitter) Trends MCP",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://x-twitter.api.trendsmcp.ai/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer token. Get your free API key at https://trendsmcp.ai"
        }
      ]
    }
  ],
  "version": "1.0.6",
  "repository": {
    "id": "1187658207",
    "url": "https://github.com/trendsmcp-ai/Trends-MCP",
    "source": "github"
  },
  "websiteUrl": "https://trendsmcp.ai",
  "description": "Twitter (X) trends over time, with growth for any keyword. Free key at trendsmcp.ai"
}