LunarCrush

Query LunarCrush social and market data: sentiment, engagement, creator metrics and price history for crypto, stocks…

Add to Agentman Studio

Opens Agent Studio, where connecting is one click. The connector URL below works in any MCP client.

Paste it into any MCP client. Setup docs

Resources

What the LunarCrush connector does

The LunarCrush MCP server lets Claude, ChatGPT and any MCP client query LunarCrush's social-media and market dataset in plain English. It exposes 15 tools covering sentiment, engagement, creator influence, top posts and price history for cryptocurrencies, stocks, brands, sports and people. Every tool is annotated read-only. Nothing here trades, and full data needs a paid plan.

Verified connector

Listed by Anthropic as a partner connector in its Connectors Directory.

Connection checked by Agentman on .

Anthropic states this reflects the level of review a connector received, not a security audit.

LunarCrush tools (15)

  • listRead-only

    List of social topics within a category sorted and filtered by available metrics and sectors.

  • topicRead-only

    Summary snapshot of all social metrics and insights for any social topic, keyword, cryptocurrency, stock, or custom search/collection slug like lc1s5M27Jq

  • topic_time_seriesRead-only

    Historical time-series metrics for a social topic, keyword, cryptocurrency, or stock, or custom search/collection slug like lc1s5M27Jq

  • topic_postsRead-only

    Top social posts by interactions for a given time period. Identify the most influential narrative and the posts driving social metrics.

  • keyword_time_seriesRead-only

    Historical time series social metrics for any keyword or phrase. Use for exact keyword/phrase analytics.

  • keyword_postsRead-only

    Top social posts by interactions for a given time period. Identify the most influential narrative and the posts driving social metrics. Use for exact keyword/phrase analytics.

  • creatorRead-only

    Creator's summary snapshot of social metrics and insights. Use for deeper research on a social media account/creator/influencer.

  • creator_postsRead-only

    Top social posts for a specific social media account by unique id or screen name and time period. Use for deeper research on a social media account/creator/influencer.

  • creator_time_seriesRead-only

    Historical time-series metrics for a social media account by unique id or screen name.

  • postRead-only

    Social post details. Ids of posts can be inferred by the public URL link to the post.

  • cryptocurrenciesRead-only

    List of cryptocurrencies sorted by available metrics and filtered by a sector.

  • stocksRead-only

    List of stocks sorted by available metrics and filtered by a sector.

  • searchRead-only

    Search for any keyword or account. Returns matching topics, creator accounts, and the top social posts to help with exact topic lookup or ai context on a keyword.

  • fetchRead-only

    Fetch a lunarcrush.ai context using a specific path like /topic/bitcoin or /topic/bitcoin/posts or /list/cryptocurrencies/altrank or /creator/x/lunarcrush or /post/x/1234567890

  • authRead-only

    Get subscription and rate limit information. Optionally provide an API key to test.

Read from the server on 2026-08-17, including each tool's own safety annotations.

Limits

  • The directory's tool names are capitalised; the server's are not. Anthropic's snapshot lists List, Topic, Search, Fetch, Authentication and the rest in title case, while the live handshake returns list, topic, search, fetch and auth. MCP tool names are case-sensitive, so code written from the directory listing fails against the running server — and a comparison that lowercases both sides scores this as a perfect match. Authentication is additionally a different word from the live auth. Take names from the handshake.
  • This is measurement, not advice. The tools return social and market metrics. Nothing here is a recommendation to buy, sell or hold anything, and no tool on this server can transact. Galaxy Score, AltRank, TopicRank and CreatorRank are LunarCrush's own proprietary composites, not standardised measures; how they are weighted is not published at the level needed to reproduce them independently.
  • Free access is materially degraded, not merely rate-limited. An unauthenticated request to lunarcrush.ai on 2026-08-17 returned a real response with several metric values replaced by placeholder dashes and a closing line reading "Limited data mode". LunarCrush's own support pages say there is no free trial and that full API and MCP use requires a paid plan.
  • Quota is the binding constraint. LunarCrush publishes Hobby at 4 requests per minute and 100 per day, Individual at 10 per minute and 2,000 per day, Builder at 100 per minute and 20,000 per day, Scale at 500 per minute and 100,000 per day, with Enterprise custom. Exceeding a limit returns HTTP 429, and the vendor's guidance is exponential backoff starting at one second plus caching anything that does not need to be live. An agent that polls a list call in a loop will exhaust a small plan quickly.
  • Endpoint access is gated by plan, not just call volume. LunarCrush's developer page states the free Hobby tier reaches market-data endpoints only, with social, creator and AI endpoints unlocking on paid plans. So a low-tier key can enumerate all 15 tools and still not get useful answers from the creator and social ones.
  • The vendor's own support article names three tools that do not exist. LunarCrush's article on autonomous agent use cites get_topic_summary, get_trending_topics and get_asset_metrics. No tool by any of those names was returned by the live server on 2026-08-17. The handshake is authoritative; treat that article as describing capabilities rather than callable tool names.
  • The directory listing is four tools behind. Anthropic's snapshot names 11; the live server returned 15. The four absent from the snapshot are the keyword pair and two of the three creator tools, so a reader working from the directory alone would not know exact-phrase analytics or creator history existed.
  • Metric semantics need reading before use. Sentiment is a 0–100 engagement-weighted percentage of positive posts, per LunarCrush — not a directional forecast. Social metrics aggregate over a rolling 24-hour window. Coverage is not guaranteed either: LunarCrush states a coin needs active trading volume and detectable social conversation to be tracked at all, and listing requests are reviewed rather than granted.
  • Terms and privacy could not be read. Both pages return an HTML shell with the policy text rendered client-side, so no automated fetch retrieved the body on 2026-08-17. This page therefore makes no claim about LunarCrush's data-licensing, redistribution or warranty terms. Read them yourself before redistributing anything the connector returns.
  • We did not exercise any MCP tool. Our check was a tools/list handshake plus an anonymous initialize against the endpoint. Behavioural claims above come from the tool schemas, from unauthenticated requests to LunarCrush's public HTTP interface, or from LunarCrush's own documentation, each attributed in Sources.

Frequently asked questions

Do I need a paid LunarCrush plan to use the MCP server?

In practice, yes. LunarCrush states that fully using the API and MCP requires a paid plan, and that all commercial use requires one. A free account exists but returns what LunarCrush labels limited data mode, where several metrics come back masked rather than populated. The Hobby tier is capped at market-data endpoints; social, creator and AI endpoints unlock on paid plans.

Why does the LunarCrush connector answer without asking me to sign in?

Because discovery is open and the data is not. An anonymous request to the endpoint on 2026-08-17 completed the MCP initialize handshake and returned all 15 tool definitions with no credential. The server separately publishes an OAuth protected-resource descriptor declaring an authorization server. Tool results without a token fall back to LunarCrush's limited data mode.

Are the LunarCrush MCP tools safe to auto-approve in an agent?

All 15 carry readOnlyHint true and destructiveHint false, so none is annotated as writing or deleting anything. Nothing on this server places a trade, moves money or changes your LunarCrush account. The real cost of an unattended loop is quota: every call counts against your plan's per-minute and daily limit, and exceeding it returns HTTP 429.

What does openWorldHint false mean on a live social-data connector?

It means each tool queries LunarCrush's own processed dataset, not the open web. The server never browses X, Reddit or YouTube during your call. LunarCrush ingests those platforms continuously, filters spam and bots, scores sentiment and stores the result, and the tools read that store. The dataset still changes hourly, so repeat calls can return different numbers.

Why do LunarCrush's tool names collide with other MCP connectors?

Because six of the fifteen are single generic words: list, topic, post, search, fetch and stocks. In an agent running several connectors at once, a bare search or fetch gives the model nothing to distinguish LunarCrush from any other source. Most clients namespace tools by server, but where yours does not, rename them or load this connector alone.

Which social networks and assets does LunarCrush cover?

LunarCrush states it collects from X, Reddit, YouTube, TikTok, Instagram and major news outlets, with market data sourced from multiple exchanges. It reports coverage of over 10,000 cryptocurrencies and over 7,000 stocks across more than 30 categories. The list tool's own category enum spans 36 values, reaching well past finance into sports leagues, musicians, luxury brands and countries.

Can I get historical LunarCrush data through MCP, or only the current snapshot?

Both. Three tools return time series: topic_time_series, keyword_time_series and creator_time_series. The topic and creator variants accept 1d, 1w, 1m, 3m, 6m, 1y or all; the keyword one starts at 1w and has no single-day option. All three default to a week of hourly data, with daily buckets on longer ranges, and let you request named metrics instead of every series.

Sources

More Finance connectors

  • Affinity

    Search your CRM, prep for meetings and update deal records from your AI assistant.

  • Aiera

    Pull earnings-call transcripts, event calendars, SEC filings and company publications into your AI assistant.

  • Airwallex Developer

    Search Airwallex documentation and exercise a sandbox account from an AI agent.

Browse all MCP connectorsClaude and ChatGPT setup guideBrowse AI skills

Product names and logos belong to their owners. Agentman is not affiliated with a connector's maker unless the page says the connector is built and run by Agentman.

Use it in an agent

Put LunarCrush to work.

Connect LunarCrush once and your agents call these tools on their own: on a schedule, in a workflow, with nobody at the keyboard.

Open in Agentman Studio
Call (650) 285-1019Our AI receptionist answers.