The Lunarcrush MCP connector routes your AI agent's tool calls to Lunarcrush's own MCP server through Scalekit. Each user signs in to Lunarcrush once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 15 tools.
- Tools
- 15
- What they doRead · write · destructive
- 15 · 0 · 015 read0 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Scalekit's or your own
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Lunarcrush MCP connection
In AgentKit > Connections, create a Lunarcrush MCP connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Scalekit credentials are available for Lunarcrush MCP server, so you don't need to register an OAuth app.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'lunarcrushmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Lunarcrush MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'lunarcrushmcp_auth',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "lunarcrushmcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Lunarcrush MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="lunarcrushmcp_auth",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toollunarcrushmcp_authCheck subscription and rate limit information for the current API key, or test an alternate API key.Read-onlyAuth
Check subscription and rate limit information for the current API key, or test an alternate API key.
Inputs
apiKeystring- Optional alternate API key to use for this request.
lunarcrushmcp_creatorGet a summary snapshot of social metrics and insights for a specific social media account.Read-onlyCreator
Get a summary snapshot of social metrics and insights for a specific social media account.
Inputs
networkstringrequired- Social network to filter by.one of
xtwittertiktokyoutuberedditinstagram screenNamestringrequired- Screen name or unique ID of the social media account.
lunarcrushmcp_creator_postsGet top social posts for a specific social media account by screen name or unique ID.Read-onlyCreator Posts
Get top social posts for a specific social media account by screen name or unique ID.
Inputs
networkstringrequired- Social network to filter by.one of
xtwittertiktokyoutuberedditinstagram screenNamestringrequired- Screen name or unique ID of the social media account.
from_datestring- Start date for the date range (YYYY-MM-DD). Use with to_date instead of interval.
intervalstring- Time window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.one of
1d1w1m3m6m1yall limitnumber- Maximum number of results to return.default
100 to_datestring- End date for the date range (YYYY-MM-DD). Leave blank to get posts up to now.
lunarcrushmcp_creator_time_seriesGet historical time-series social metrics for a specific social media account.Read-onlyCreator Time Series
Get historical time-series social metrics for a specific social media account.
Inputs
networkstringrequired- Social network to filter by.one of
xtwittertiktokyoutuberedditinstagram screenNamestringrequired- Screen name or unique ID of the social media account.
intervalstring- Time window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.one of
1d1w1m3m6m1yall metricsarray- One or more metrics to include. Leave blank to return all metrics.
lunarcrushmcp_cryptocurrenciesGet a list of cryptocurrencies sorted by social metrics and optionally filtered by sector.Read-onlyCryptocurrencies
Get a list of cryptocurrencies sorted by social metrics and optionally filtered by sector.
Inputs
limitnumber- Maximum number of results to return.default
100 sectorstring- Filter results to a specific sector.one of
stablecoindefinftdotbscmemeavalanchealgoranddaowalletsaiarbitrumgaminglayer-1layer-2lending-borrowingliquid-staking-tokensbrc20exchange-tokensreal-world-assetsdepinfangamblingrunesdescisportssocialfianalyticseventsreal-estatebitcoin-ecosystemstacks-ecosystembase-ecosystemsolana-ecosystemai-agentsdefaizkoraclestoragemade-in-usasuiinjcardanopowposmusicinsuranceprivacyenergypump-funpredictionentertainmenthealthcarebtcfiinteroperabilitymove-to-earnbittensor-ecosystemderivativesperpetualsopenclaw sortstring- Sort results by this metric.one of
alt_rankgalaxy_scoreclosepercent_change_1hpercent_change_24hpercent_change_7dinteractionsposts_activecontributors_activesentimentsocial_dominancemarket_capmarket_dominancevolume_24hcirculating_supplytopic_rank
lunarcrushmcp_fetchFetch a LunarCrush context using a URL-friendly path such as /topic/bitcoin.Read-onlyFetch
Fetch a LunarCrush context using a URL-friendly path such as /topic/bitcoin.
Inputs
idstringrequired- URL-friendly path to the LunarCrush context (e.g. /topic/bitcoin or /creator/x/elonmusk).
lunarcrushmcp_keyword_postsGet top social posts for a keyword or phrase over a given time period.Read-onlyKeyword Posts
Get top social posts for a keyword or phrase over a given time period.
Inputs
keywordstringrequired- Keyword or phrase to search. Use lowercase a-z, 0-9, #, $, _ and spaces only.
from_datestring- Start date for the date range (YYYY-MM-DD). Use with to_date instead of interval.
intervalstring- Time window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.one of
1d1w1m3m6m1yall limitnumber- Maximum number of results to return.default
100 networkstring- Social network to filter by.one of
allxtwittertiktokyoutuberedditinstagramnews to_datestring- End date for the date range (YYYY-MM-DD). Leave blank to get posts up to now.
lunarcrushmcp_keyword_time_seriesGet historical time-series social metrics for a keyword or phrase.Read-onlyKeyword Time Series
Get historical time-series social metrics for a keyword or phrase.
Inputs
keywordstringrequired- Keyword or phrase to search. Use lowercase a-z, 0-9, #, $, _ and spaces only.
intervalstring- Time window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.one of
1w1m3m6m1yall metricsarray- One or more metrics to include. Leave blank to return all metrics.
networkstring- Social network to filter by.one of
allxtwittertiktokyoutuberedditinstagramnews
lunarcrushmcp_listGet a list of social topics in a category sorted and filtered by available metrics.Read-onlyList
Get a list of social topics in a category sorted and filtered by available metrics.
Inputs
categorystring- Filter topics by category. Leave blank for all categories.one of
fashion-brandstechnology-brandssocial-networksbundesliganhlproductstravel-destinationsla-ligaautomotive-brandsvc-firmsncaa-footballluxury-brandsgamingnbanascarufcagenciesmusiciansnftsexchangescurrenciescelebritiesstocksncaa-basketballeventscountriesmlsmlbformula-1nflpremier-leaguefinancecryptocurrencieschampions-leaguepga-golfersliga-mx limitnumber- Maximum number of results to return.default
100 sortstring- Sort results by this metric.one of
interactionsposts_activecontributors_activesentimentsocial_dominancetopic_rank
lunarcrushmcp_postGet details for a specific social post by network and post ID.Read-onlyPost
Get details for a specific social post by network and post ID.
Inputs
idstringrequired- URL-friendly path to the LunarCrush context (e.g. /topic/bitcoin or /creator/x/elonmusk).
networkstringrequired- Social network to filter by.one of
xtwittertiktokyoutuberedditinstagramnews
lunarcrushmcp_searchSearch for any keyword or account and return matching topics, creators, and assets.Read-onlySearch
Search for any keyword or account and return matching topics, creators, and assets.
Inputs
querystringrequired- Search query or phrase to find matching topics, creators, or assets.
lunarcrushmcp_stocksGet a list of stocks sorted by social metrics and optionally filtered by sector.Read-onlyStocks
Get a list of stocks sorted by social metrics and optionally filtered by sector.
Inputs
limitnumber- Maximum number of results to return.default
100 sectorstring- Filter results to a specific sector.one of
basic-materialscommunication-servicesconsumer-cyclicalconsumer-defensiveenergyfinancial-serviceshealthcareindustrialsreal-estatetechnologyutilitiesbanksetfbitcoin-spot-etfbitcoin-futures-etfethereum-spot-etfbitcoin-treasuriescrypto-etfsdefensecrypto-treasuriesbitcoin-miners sortstring- Sort results by this metric.one of
alt_rankgalaxy_scoreclosepercent_change_24hinteractionsposts_activecontributors_activesentimentsocial_dominancemarket_capmarket_dominancevolumetopic_rank
lunarcrushmcp_topicGet a summary snapshot of all social metrics and insights for any social topic, keyword, or asset.Read-onlyTopic
Get a summary snapshot of all social metrics and insights for any social topic, keyword, or asset.
Inputs
topicstringrequired- Topic slug (lowercase a-z, 0-9, #, $, _ and spaces). Example: bitcoin.
lunarcrushmcp_topic_postsGet top social posts by interactions for a topic over a given time period.Read-onlyTopic Posts
Get top social posts by interactions for a topic over a given time period.
Inputs
topicstringrequired- Topic slug (lowercase a-z, 0-9, #, $, _ and spaces). Example: bitcoin.
from_datestring- Start date for the date range (YYYY-MM-DD). Use with to_date instead of interval.
intervalstring- Time window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.one of
1d1w1m3m6m1yall limitnumber- Maximum number of results to return.default
100 networkstring- Social network to filter by.one of
allxtwittertiktokyoutuberedditinstagramnews to_datestring- End date for the date range (YYYY-MM-DD). Leave blank to get posts up to now.
lunarcrushmcp_topic_time_seriesGet historical time-series social metrics for a social topic, keyword, cryptocurrency, or stock.Read-onlyTopic Time Series
Get historical time-series social metrics for a social topic, keyword, cryptocurrency, or stock.
Inputs
topicstringrequired- Topic slug (lowercase a-z, 0-9, #, $, _ and spaces). Example: bitcoin.
intervalstring- Time window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.one of
1d1w1m3m6m1yall metricsarray- One or more metrics to include. Leave blank to return all metrics.
No tools match.
