Lunarcrush MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. 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>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'lunarcrushmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Lunarcrush MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'lunarcrushmcp_list',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "lunarcrushmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="lunarcrushmcp_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Series topic time, keyword time, creator time — Get historical time-series social metrics for a social topic, keyword, cryptocurrency, or stock
• Posts topic, keyword, creator — Get top social posts by interactions for a topic over a given time period
• Topic records — Get a summary snapshot of all social metrics and insights for any social topic, keyword, or asset
• Stocks records — Get a list of stocks sorted by social metrics and optionally filtered by sector
• Search records — Search for any keyword or account and return matching topics, creators, and assets
• Post records — Get details for a specific social post by network and post ID

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

lunarcrushmcp_auth#Check subscription and rate limit information for the current API key, or test an alternate API key.1 param▾

Check subscription and rate limit information for the current API key, or test an alternate API key.

NameTypeRequiredDescription

apiKeystringoptionalOptional alternate API key to use for this request.

lunarcrushmcp_creator#Get a summary snapshot of social metrics and insights for a specific social media account.2 params▾

Get a summary snapshot of social metrics and insights for a specific social media account.

NameTypeRequiredDescription

networkstringrequiredSocial network to filter by.

screenNamestringrequiredScreen name or unique ID of the social media account.

lunarcrushmcp_creator_posts#Get top social posts for a specific social media account by screen name or unique ID.6 params▾

Get top social posts for a specific social media account by screen name or unique ID.

NameTypeRequiredDescription

networkstringrequiredSocial network to filter by.

screenNamestringrequiredScreen name or unique ID of the social media account.

from_datestringoptionalStart date for the date range (YYYY-MM-DD). Use with to_date instead of interval.

intervalstringoptionalTime window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.

limitnumberoptionalMaximum number of results to return.

to_datestringoptionalEnd date for the date range (YYYY-MM-DD). Leave blank to get posts up to now.

lunarcrushmcp_creator_time_series#Get historical time-series social metrics for a specific social media account.4 params▾

Get historical time-series social metrics for a specific social media account.

NameTypeRequiredDescription

networkstringrequiredSocial network to filter by.

screenNamestringrequiredScreen name or unique ID of the social media account.

intervalstringoptionalTime window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.

metricsarrayoptionalOne or more metrics to include. Leave blank to return all metrics.

lunarcrushmcp_cryptocurrencies#Get a list of cryptocurrencies sorted by social metrics and optionally filtered by sector.3 params▾

Get a list of cryptocurrencies sorted by social metrics and optionally filtered by sector.

NameTypeRequiredDescription

limitnumberoptionalMaximum number of results to return.

sectorstringoptionalFilter results to a specific sector.

sortstringoptionalSort results by this metric.

lunarcrushmcp_fetch#Fetch a LunarCrush context using a URL-friendly path such as /topic/bitcoin.1 param▾

Fetch a LunarCrush context using a URL-friendly path such as /topic/bitcoin.

NameTypeRequiredDescription

idstringrequiredURL-friendly path to the LunarCrush context (e.g. /topic/bitcoin or /creator/x/elonmusk).

lunarcrushmcp_keyword_posts#Get top social posts for a keyword or phrase over a given time period.6 params▾

Get top social posts for a keyword or phrase over a given time period.

NameTypeRequiredDescription

keywordstringrequiredKeyword or phrase to search. Use lowercase a-z, 0-9, #, $, _ and spaces only.

from_datestringoptionalStart date for the date range (YYYY-MM-DD). Use with to_date instead of interval.

intervalstringoptionalTime window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.

limitnumberoptionalMaximum number of results to return.

networkstringoptionalSocial network to filter by.

to_datestringoptionalEnd date for the date range (YYYY-MM-DD). Leave blank to get posts up to now.

lunarcrushmcp_keyword_time_series#Get historical time-series social metrics for a keyword or phrase.4 params▾

Get historical time-series social metrics for a keyword or phrase.

NameTypeRequiredDescription

keywordstringrequiredKeyword or phrase to search. Use lowercase a-z, 0-9, #, $, _ and spaces only.

intervalstringoptionalTime window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.

metricsarrayoptionalOne or more metrics to include. Leave blank to return all metrics.

networkstringoptionalSocial network to filter by.

lunarcrushmcp_list#Get a list of social topics in a category sorted and filtered by available metrics.3 params▾

Get a list of social topics in a category sorted and filtered by available metrics.

NameTypeRequiredDescription

categorystringoptionalFilter topics by category. Leave blank for all categories.

limitnumberoptionalMaximum number of results to return.

sortstringoptionalSort results by this metric.

lunarcrushmcp_post#Get details for a specific social post by network and post ID.2 params▾

Get details for a specific social post by network and post ID.

NameTypeRequiredDescription

idstringrequiredURL-friendly path to the LunarCrush context (e.g. /topic/bitcoin or /creator/x/elonmusk).

networkstringrequiredSocial network to filter by.

lunarcrushmcp_search#Search for any keyword or account and return matching topics, creators, and assets.1 param▾

Search for any keyword or account and return matching topics, creators, and assets.

NameTypeRequiredDescription

querystringrequiredSearch query or phrase to find matching topics, creators, or assets.

lunarcrushmcp_stocks#Get a list of stocks sorted by social metrics and optionally filtered by sector.3 params▾

Get a list of stocks sorted by social metrics and optionally filtered by sector.

NameTypeRequiredDescription

limitnumberoptionalMaximum number of results to return.

sectorstringoptionalFilter results to a specific sector.

sortstringoptionalSort results by this metric.

lunarcrushmcp_topic#Get a summary snapshot of all social metrics and insights for any social topic, keyword, or asset.1 param▾

Get a summary snapshot of all social metrics and insights for any social topic, keyword, or asset.

NameTypeRequiredDescription

topicstringrequiredTopic slug (lowercase a-z, 0-9, #, $, _ and spaces). Example: bitcoin.

lunarcrushmcp_topic_posts#Get top social posts by interactions for a topic over a given time period.6 params▾

Get top social posts by interactions for a topic over a given time period.

NameTypeRequiredDescription

topicstringrequiredTopic slug (lowercase a-z, 0-9, #, $, _ and spaces). Example: bitcoin.

from_datestringoptionalStart date for the date range (YYYY-MM-DD). Use with to_date instead of interval.

intervalstringoptionalTime window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.

limitnumberoptionalMaximum number of results to return.

networkstringoptionalSocial network to filter by.

to_datestringoptionalEnd date for the date range (YYYY-MM-DD). Leave blank to get posts up to now.

lunarcrushmcp_topic_time_series#Get historical time-series social metrics for a social topic, keyword, cryptocurrency, or stock.3 params▾

Get historical time-series social metrics for a social topic, keyword, cryptocurrency, or stock.

NameTypeRequiredDescription

topicstringrequiredTopic slug (lowercase a-z, 0-9, #, $, _ and spaces). Example: bitcoin.

intervalstringoptionalTime window for the data. Defaults to 1w (hourly). Use 1m or longer for daily data.

metricsarrayoptionalOne or more metrics to include. Leave blank to return all metrics.