LunarCrush
by LunarCrush
Query LunarCrush's social-media and market dataset from an AI assistant: sentiment, engagement, creator metrics and price history for crypto, stocks, brands and people. 15 tools, all read-only, bearer-token or OAuth sign-in.
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.
Connect LunarCrush via MCP
https://lunarcrush.ai/mcpWorks in any MCP-compatible client. In Agentman Studio it is one click — no config file to edit.
Use in Agentman
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 StudioLunarCrush Tools & Capabilities (15)
List of social topics within a category sorted and filtered by available metrics and sectors.
Summary snapshot of all social metrics and insights for any social topic, keyword, cryptocurrency, stock, or custom search/collection slug like lc1s5M27Jq
Historical time-series metrics for a social topic, keyword, cryptocurrency, or stock, or custom search/collection slug like lc1s5M27Jq
Top social posts by interactions for a given time period. Identify the most influential narrative and the posts driving social metrics.
Historical time series social metrics for any keyword or phrase. Use for exact keyword/phrase analytics.
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.
Creator's summary snapshot of social metrics and insights. Use for deeper research on a social media account/creator/influencer.
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.
Historical time-series metrics for a social media account by unique id or screen name.
Social post details. Ids of posts can be inferred by the public URL link to the post.
List of cryptocurrencies sorted by available metrics and filtered by a sector.
List of stocks sorted by available metrics and filtered by a sector.
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.
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
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,Authenticationand the rest in title case, while the live handshake returnslist,topic,search,fetchandauth. 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.Authenticationis additionally a different word from the liveauth. 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
listcall 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_topicsandget_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/listhandshake plus an anonymousinitializeagainst 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
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.
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.
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.
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.
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.
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.
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
- LunarCrush MCP developer documentation (retrieved 2026-08-17, HTTP 200. The URL Anthropic's directory publishes,
https://lunarcrush.com/developers/api/ai, 301-redirects here and the destination is cited. Endpoint, bearer-header authentication, Claude Desktop and Cursor config blocks, the five-key limit, and the per-plan rate-limit and endpoint-access table) · retrieved 2026-08-17 - LunarCrush support articles (retrieved 2026-08-17, HTTP 200; 58 articles enumerated from
sitemap-support.xml). Used: the Claude Code connect command, the 429 and 401 troubleshooting steps, rate limits by plan, free-tier and trial statements, data sources and processing pipeline, the sentiment definition, coverage counts, and the autonomous-agent article whose three named tools do not match the live server · retrieved 2026-08-17 robots.txtandllms.txtforlunarcrush.ai— and (retrieved 2026-08-17, HTTP 200, genuine text not an SPA shell).User-agent: *isAllow: /withContent-Signal: ai-train=yes, search=yes, ai-input=yes— the publisher expressly permits AI synthesis. Note/mcp,/sse,/auth,/authorizeand/.well-known/are Disallow-ed for crawling; the machine-readable descriptors below were fetched as directed single reads, not crawled, and no page under those paths was synthesised into prose · retrieved 2026-08-17robots.txtandllms.txtforlunarcrush.com— and (retrieved 2026-08-17, HTTP 200).Allow: /for all agents, disallowing only query-parameter crawl traps; the support and developer paths are permitted · retrieved 2026-08-17- OAuth authorization-server metadata (retrieved 2026-08-17, HTTP 200,
application/json; scopesprofile,api.read,api.write, PKCE S256, dynamic registration) and the RFC 9728 protected-resource descriptor athttps://lunarcrush.ai/.well-known/oauth-protected-resource(HTTP 200). This is the server declaring its own auth arrangement over the wire, which is what setsauthVerified· retrieved 2026-08-17 - Live
tools/listhandshake againsthttps://lunarcrush.ai/mcp— 15 tools with descriptions, input schemas and safety annotations (2026-08-17). A separate anonymousinitializeon the same date returned HTTP 200 with no authentication challenge. No tool was called · retrieved 2026-08-17 - Unauthenticated read of
https://lunarcrush.ai/topic/bitcoin(HTTP 200, 2026-08-17) — the source for the "Limited data mode" observation and the masked metric values · retrieved 2026-08-17 - LunarCrush pricing (retrieved 2026-08-17, HTTP 200; Individual $90/month, Builder $300/month, Scale $900/month, Enterprise custom, each listing the MCP server) · retrieved 2026-08-17
- LunarCrush CLI reference (retrieved 2026-08-17, HTTP 200) — the source for the roughly-48-hour window on a topic snapshot · retrieved 2026-08-17
- Anthropic Connectors Directory entry (from the 2026-08-16 directory snapshot; partner tier, financial-services and data categories, endpoint, streamable-http transport, and 11 tool names against 15 live) · retrieved 2026-08-16
- LunarCrush terms of service and privacy policy — and (both HTTP 200 on 2026-08-17, but both served as an HTML shell with the policy body rendered client-side; no text was retrievable and nothing is cited from them) · retrieved 2026-08-17
Server Info
- Category
- Finance
- Developer
- LunarCrush
- Tools
- 15
- Domain
- lunarcrush.ai
Using Claude Desktop or another MCP client? Setup docs — the connection URL above works anywhere.
Similar MCP Servers for Finance
Related Resources
Ready to connect LunarCrush?
Connect LunarCrush once and your agents call these tools on their own — on a schedule, in a workflow, with nobody at the keyboard.