Gate News MCP

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Gate news MCP for crypto news, structured events, announcements, and social sentiment.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Gate News MCP": {
      "url": "https://api.gatemcp.ai/mcp/news",
      "transport": "streamable-http"
    }
  }
}

Measured tools (18)

• news_events_explain_market_move read-only

  [Read] Explain what drove a crypto asset's price move in a given time window. Returns a concise summary (from real-time Tavily search), the latest high-priority real-time events, and supporting internal event pool items, plus data-completeness status. This tool is a data aggregator; the downstream agent performs the final attribution reasoning. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • query (required) — string — User's original question, e.g. 'Why did BTC surge?'
  • coin (required) — string — Target coin, e.g. BTC, ETH. Required at the Tool layer.
  • lang — string — zh / en. Default zh.
  • mode — string — auto / price_move / event_impact. Default auto.
  • time_range — string — Time window: 30m/1h/2h/4h/24h. Default 2h.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_events_get_event_detail read-only

  [Read] Full detail for one event_id only, including persisted impact_direction and impact_direction_reason. Filtered event list or timeline -> get_latest_events. Unknown id returns not found. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • event_id (required) — string — Required event_id from get_latest_events items—opaque digest id, not a trading pair slug or headline hash.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_events_get_latest_events read-only

  [Read] Filtered event list or timeline; each row includes event_id and persisted impact_direction/impact_direction_reason. Optional direction filter. One event_id detail -> get_event_detail. Headline/news feed -> search_news. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • coin — string — Optional comma-separated tickers e.g. BTC,ETH for digest items; not the same as search_news tickers-only heat mode.
  • limit — integer — Page size; default 20, max 100.
  • cursor — string — Optional pagination cursor.
  • end_time — string — Absolute end (ISO8601 or Unix sec/ms). Mutually exclusive with time_range.
  • direction — string — Optional filter on persisted impact_direction: positive / negative / neutral / mixed / unknown / all (default all, no filter). MCP does not re-judge direction.
  • event_type — string — Optional filter on structured digest event_type. Not search_news headline similarity/heat.
  • start_time — string — Absolute start (ISO8601 or Unix sec/ms). Mutually exclusive with time_range; pair with end_time or let server fill the other bound.
  • time_range — string — Relative window for event digest list: 1h / 24h / 7d. Mutually exclusive with start_time/end_time; omit all for last 24h or server default when time filter disabled. Not CPI/Fed macro series—use macro indicator tools.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_events_get_market_move_report read-only

  [Read] Query a stored market-move attribution report by symbol, optional report_id, or optional event_id. Lookup priority is report_id > event_id > latest report for symbol. Returned event/report timestamps are UTC0 unless the field name ends in _utc8. This tool never requests report regeneration and does not expose is_make_new. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • symbol (required) — string — Required cryptocurrency symbol, for example BTC or TAIKO; 1-20 characters and normalized to uppercase.
  • event_id — string — Optional market-move event ID. When report_id and event_id are omitted, returns the latest report for symbol.
  • report_id — string — Optional report ID for an exact lookup. Takes priority over event_id when both are provided.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_events_list_market_move_reports read-only

  [Read] List stored market-move attribution reports for one symbol, filtering by an inclusive UTC0 updated_at range and sorting results by event_time descending. Reports may be updated after their market event, so updated_at can be later than event_time. Timezone-less inputs are UTC0; inputs with an explicit offset are converted to UTC0 before the read-only service-ai-pe query. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • symbol (required) — string — Required cryptocurrency symbol, for example ETH; 1-20 characters and normalized to uppercase.
  • start_time (required) — string — Required inclusive lower bound for report updated_at in UTC0. Accepts ISO 8601 or YYYY-MM-DD HH:MM:SS; a value without a timezone is interpreted as UTC0, and an explicit offset is converted to UTC0 before calling service-ai-pe.
  • end_time (required) — string — Required inclusive upper bound for report updated_at in UTC0. Accepts ISO 8601 or YYYY-MM-DD HH:MM:SS; a value without a timezone is interpreted as UTC0, an explicit offset is converted to UTC0, and the value must not precede start_time.
  • limit — integer — Maximum reports to return; omitted or 0 defaults to 20, otherwise allowed range is 1-100.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_feed_get_exchange_announcements read-only

  [Read] Venue-published exchange notices: listings, delistings, maintenance. Media rumors or general crypto headlines -> search_news. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • to — integer — Window end Unix sec inclusive; forwarded downstream and filtered locally.
  • coin — string — Comma-separated tickers; omit if empty.
  • from — integer — Window start Unix sec; omit if <= 0; MCP also filters locally after fetch.
  • limit — integer — Max rows; omit if unset or <= 0; cap 100 when set.
  • query — string — Optional text filter on official venue notices; omit if empty. For general crypto media headlines use search_news—not a substitute for venue-published listing API.
  • exchange — string — Venue id for API platform; used when platform is empty; not merged with query.
  • platform — string — URL param platform; wins over exchange; if empty falls back to exchange.
  • announcement_type — string — listing / delisting / maintenance / all. Omit or unknown value is treated as all (no type filter).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_feed_get_hot_topics read-only

  [Read] Get the top 2-4 social discussion themes for one coin over the latest 4h, including direction, influence, sentiment, platforms, and representative evidence posts. For arbitrary social search use search_ugc; for X/Twitter-only narrative research use search_x. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • coin (required) — string — Required non-empty cryptocurrency ticker, for example ETH. Leading and trailing whitespace is removed and the value is normalized to uppercase. Unknown or no-data tickers may return an empty result with hide_reason=no_data; no coin-dictionary validation is performed.
  • limit — integer — Number of hot topics to return. Default 4; allowed range 2 to 4.
  • window — string — Aggregation window. Only 4h is currently supported; default 4h.
  • platforms — string — Comma-separated social platforms; default all. Supported: all, gate_square, binance_square, twitter, telegram, youtube, reddit, discord. all cannot be combined with another platform.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_feed_get_mention_burst read-only

  [Read] Get a coin's 24h multi-platform social mention burst signal, growth, sentiment direction, platform breakdown, and display eligibility. For general sentiment ratios and sample tweets use get_social_sentiment; for individual social discussions use search_ugc. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • coin (required) — string — Required non-empty cryptocurrency ticker, for example BTC. Leading and trailing whitespace is removed and the value is normalized to uppercase. Unknown or no-data tickers may return an empty result with hide_reason=no_data; no coin-dictionary validation is performed.
  • window — string — Aggregation window. Only 24h is currently supported; default 24h.
  • platforms — string — Comma-separated social platforms; default all. Supported: all, gate_square, binance_square, twitter, telegram, youtube, reddit, discord. all cannot be combined with another platform.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_feed_get_social_sentiment read-only

  [Read] Aggregate per-coin social sentiment for a time range: overall sentiment, positive/negative split, mention count, and sample tweets. X/Twitter post search or tweet-level evidence -> search_x. Multi-platform social thread search -> search_ugc. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • coin — string — Tickers e.g. BTC or BTC,ETH for per-coin aggregates: overall sentiment, positive/negative split, mention count, sample tweets (top_tweets order); omit defaults to BTC server-side. X/Twitter post search or tweet-level evidence -> search_x. Multi-platform social thread search -> search_ugc.
  • time_range — string — 1h / 24h (default) / 7d window for per-coin sentiment aggregation (overall sentiment, positive/negative split, mention count).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_feed_search_news read-only

  [Read] Search the platform news index for headlines, news items, and briefing-style result lists. Open-web research with synthesized answers and cited external pages -> web_search. Event catalog with event_id -> get_latest_events. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • coin — string — Comma-separated tickers mapped to API tickers; sent only when query is empty (omitted when query is set). Heat mode supports news-item / briefing-style lists on the platform index—not open-web synthesis (web_search).
  • lang — string — MCP-only filter on metadata.lang or top-level lang; not sent to upstream API.
  • page — integer — Page number mapped to API page; default 1.
  • limit — integer — Page size mapped to API page_size; default 10, max 100.
  • query — string — Non-empty: similarity mode (no tickers; default similarity_score 0.6). Empty: heat mode (top_total_score 1; optional coin/tickers). Platform news index for headlines, news items, and briefing-style result lists—not open-web research with synthesized answers and cited external pages (web_search) or event catalog with event_id (get_latest_events).
  • sort_by — string — e.g. time (default); similarity mode with top_total_score 0 may still apply MCP local time sort.
  • end_time — string — End time mapped to API to (Unix sec). Ignored when time_range is set. End-only defaults start to 24h before end.
  • platform — string — Source platform name for API platform (e.g. panews, theblock).
  • start_time — string — Start time (ISO8601 or Unix sec/ms) mapped to API from. Ignored when time_range is set. Start-only defaults end to now; both empty defaults last 7d when time_range is also empty.
  • time_range — string — Optional preset window: 1h / 24h (default when preset value invalid) / 7d / 30d. When non-empty, overrides start_time/end_time and maps to API from/to (Unix epoch seconds). Omit to use start_time/end_time or implicit last-7d when both are empty.
  • platform_type — string — Legacy: maps to API platform when platform is omitted; omit platform when value is all.
  • top_total_score — ['null', 'integer'] — Only when query empty (0 or 1); non-empty query forces similarity mode.
  • similarity_score — string — Similarity threshold; default 0.6 when query set; when query empty only sent if explicitly set.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_feed_search_ugc read-only

  [Read] Reddit/Discord/Telegram/YouTube-style UGC: non-empty query uses vector API; coin without query uses OpenSearch. Both empty invalid. X/Twitter narrative -> search_x; headlines -> search_news. Not macro economic statistics; not structured event list -> get_latest_events. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • coin — string — Ticker filter; with query filters results; without query required with index for OpenSearch list mode.
  • limit — integer — Max items; default 10, max 50.
  • query — string — Optional NL query; non-empty uses vector search. May combine with coin; both empty is invalid.
  • domain — string — UGC topical bucket: crypto / defi / finance / macro / ai_agent / web3_dev / all (default all). macro = social discussion about macro themes, not CPI/Fed/unemployment statistics (use macro data tools) or get_latest_events.
  • channel — string — Optional source channel e.g. r/ethereum or handle.
  • sort_by — string — relevance (default) / upvotes / recent.
  • platform — string — reddit / discord / telegram / youtube / all (default all).
  • time_range — string — 1h / 24h / 7d (default) / 30d / all.
  • quality_tier — string — A (default, high quality) / B / all.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_feed_search_x read-only

  [Read] Search and analyze X/Twitter discussions for a topic, with tweet-level evidence and cited posts. Aggregate social mood, sentiment score, or positive/negative split -> get_social_sentiment. Open-web pages -> web_search. Multi-platform social search -> search_ugc. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • days — integer — Lookback days when time_range omitted; omitted or <=0 treated as 1 (24h); min 1 when explicitly set.
  • lang — string — Answer language: zh (default) / en / auto.
  • model — string — Override configured Grok model id.
  • query — string — X/Twitter topic for tweet-level evidence and cited posts; English recommended. Empty returns no results. Aggregate social mood, sentiment score, or positive/negative split -> get_social_sentiment. Open-web pages -> web_search. Multi-platform social search -> search_ugc.
  • time_range — string — Preferred recency window for search_x: 1h / 24h (default) / 7d. Takes precedence over days when set.
  • allowed_handles — ['null', 'array'] — Include these X handles without @, max 10; mutually exclusive with excluded_handles.
  • excluded_handles — ['null', 'array'] — Exclude these handles, max 10.
  • enable_image_understanding — boolean — Analyze images in posts.
  • enable_video_understanding — boolean — Analyze video in posts.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_feed_web_search read-only

  [Read] Search the open web and return a synthesized answer with cited external pages. Built-in headline lookup, news-item search, or briefing-style news list -> search_news. X/Twitter-only discussion or tweet evidence -> search_x. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • coin — string — Optional ticker or project (e.g. BTC, ETH) to focus the open-web synthesized answer—not platform news index tickers (search_news).
  • lang — string — Answer language: zh (default) / en / auto.
  • mode — string — Answer length: analysis (default, fuller synthesized text) or brief (~100 chars). Not chart/indicator technical analysis (RSI/MACD).
  • limit — integer — Max cited external pages in the answer; default 5, max 10.
  • query — string — Required NL question: search the open web and return a synthesized answer with cited external pages—not built-in headline lookup, news-item search, or briefing-style news list (search_news), nor X/Twitter-only discussion or tweet-level evidence (search_x).
  • time_range — string — Recency window for open-web synthesis with cited external pages: 1h / 24h (default) / 7d / 30d. Not DeFi/TVL dashboard metrics (use platform-metrics tools).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_prediction_get_event_signal read-only

  [Read] Single event signal from dws_external_event_signal_hf by event_ref (venue:venue_event_id). window 1h/24h/7d (default 24h). Returns outcome_probabilities, volume_flow, directional_context, optional markets[] (default include_markets=true). depth_summary always null—use get_market_orderbook for live depth. daily_ranking when rank index configured. Discover event_ref -> search_events. include_orderbook_summary ignored. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • event_ref (required) — string — Required. venue:venue_event_id (split on first colon; id may contain more colons). Discover via search_events.
  • venue — ['null', 'array'] — Optional; each non-empty value must equal event_ref venue or invalid_param.
  • window — string — Recency filter on part_hour; default 24h. Allowed: 1h, 24h, 7d (case-insensitive).
  • include_markets — ['null', 'boolean'] — Omitted or null defaults true. false omits markets[]; true parses embedded markets or enriches from predictionMarketIndex.
  • include_orderbook_summary — boolean — Deprecated and ignored; depth_summary is always null—use get_market_orderbook.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_prediction_get_fastest_rising_ranking read-only

  [Read] Daily venue/overall ranking by probability rise (UTC rank_date). Optional venue[], category, status (same as volume_delta ranking). Drops rows missing open_mid_probability_utc or probability_delta_today. Requires predictionRankIndex. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • limit — ['null', 'integer'] — Page size; default 20, max 100.
  • venue — ['null', 'array'] — Optional venue filter. Allowed: polymarket, predict_fun.
  • status — string — Optional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active.
  • category — string — Optional category filter: exact term on rank index field category; omit or all to disable.
  • date_utc — string — UTC date in YYYY-MM-DD. Defaults to today_utc.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_prediction_get_market_orderbook read-only

  [Read] Live current order book only (mode=current). depth 1-20 (default 20). polymarket: market_id=venue_market_id; needs opensearch.predictionMarketIndex for token lookup (else not_implemented); yes/no CLOB /book in parallel—partial if one side fails, tool error only if both fail. predict_fun: official numeric market_id (not polymarket ids); needs predictFunAPIKey—empty/missing config returns partial_not_configured (no HTTP); API/parse errors return partial (not internal); 404 resource_not_found. Rejects history/granularity/time/page_token. snapshot_time/book_levels/best_* may be null when partial. Event list/signal -> search_events / get_event_signal. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • venue (required) — string — Required. polymarket or predict_fun. polymarket needs predictionMarketIndex; predict_fun needs predictFunAPIKey (else partial_not_configured, not a tool error).
  • market_id (required) — string — Required. polymarket: venue_market_id in dws_prediction_market_hf (token lookup). predict_fun: official numeric id (e.g. 356640), not polymarket venue_market_id.
  • mode — string — Empty or current only (default current). history and other values rejected.
  • depth — ['null', 'integer'] — yes_bids/yes_asks top-N levels; default 20; allowed 1-20 inclusive; out of range invalid_param.
  • end_time — string — Unsupported; if set, request is rejected.
  • page_token — string — Unsupported; if set, request is rejected.
  • start_time — string — Unsupported; if set, request is rejected.
  • granularity — string — Unsupported; if set, request is rejected.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_prediction_get_volume_delta_ranking read-only

  [Read] Daily venue/overall ranking by volume delta (UTC rank_date). Optional venue[], category (exact term on rank index), status (active/closed/resolved/all; default active). Requires opensearch.predictionRankIndex. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • limit — ['null', 'integer'] — Page size; default 20, max 100.
  • venue — ['null', 'array'] — Optional venue filter. Allowed: polymarket, predict_fun.
  • status — string — Optional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active.
  • category — string — Optional category filter: exact term on rank index field category; omit or all to disable.
  • date_utc — string — UTC date in YYYY-MM-DD. Defaults to today_utc.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_prediction_search_events read-only

  [Read] Search prediction events on opensearch.predictionEventSignalIndex (dws_prediction_event_signal_hf alias, hourly UNIQUE part_hour+venue+venue_event_id). query/coin/category optional; coin-only unsupported_filter. status filters event_status; status_tags from status_json_array. sort recently_listed uses create_time (first_seen); volume_delta_today uses total_volume_usd_24h (no volume_delta column). category filter: event_category_primary or lead_market_category_primary; excludes empty event_category_primary. Collapse venue_event_id. with_markets: source_markets_json or predictionMarketIndex. Detail -> get_event_signal (external); orderbook -> get_market_orderbook. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

  Parameters:

  • coin — string — Optional coin ticker; cannot be used alone without query or category (unsupported_filter). With query/category expands text recall only (best_effort).
  • limit — ['null', 'integer'] — Page size; default 20, max 100.
  • query — string — Optional full-text query; all of query, coin, category are optional.
  • venue — ['null', 'array'] — Optional venue filter. Allowed: polymarket, predict_fun.
  • status — string — Filter by ES event_status; default active. Allowed: active, closed, resolved, all. Response status_tags comes from status_json_array.
  • sort_by — string — Sort key; default attention. Allowed: attention, volume, liquidity, recently_listed, probability_change, volume_delta_today (maps to total_volume_usd_24h on signal index).
  • category — string — Optional primary category enum (crypto_price, sports, elections, …). Matches event_category_primary or lead_market_category_primary.
  • page_token — string — Base64URL page token from prior next_page_token; filters must match first page.
  • with_markets — boolean — When true, attach market summaries from source_markets_json or predictionMarketIndex.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.