Plug LunarCrush into any MCP client

The LunarCrush MCP server exposes the platform's social intelligence to Claude, Cursor, and any MCP-aware client at https://lunarcrush.ai/mcp. It authenticates with the same Authorization: Bearer <API_KEY> header as the API, and every tool runs within your plan's API limits.

Configuration

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "lunarcrush": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://lunarcrush.ai/mcp",
        "--header",
        "Authorization: Bearer <API_KEY>"
      ]
    }
  }
}

Cursor (.cursor/mcp.json), and other clients that accept a URL:

{
  "mcpServers": {
    "lunarcrush": {
      "url": "https://lunarcrush.ai/mcp",
      "headers": { "Authorization": "Bearer <API_KEY>" }
    }
  }
}

Authentication

All requests use HTTPS and return JSON. Authenticate every call with an Authorization: Bearer <API_KEY> header. The base URL is https://lunarcrush.com/api4. The same key powers the webapp, the CLI, and the MCP server. You can hold up to five active keys at once; generate, label, rotate, and revoke them on the API Keys page. Keep keys secret — if one leaks, delete it and generate a new one.

Rate limits and plan gating

Every request counts against your plan's per-minute and daily quota. Limits and endpoint access are set by your subscription tier and match the plans on the pricing page:

Plan	API access and rate limit
Hobby	Market data endpoints, 4 requests/min, 100 per day
Individual	Limited endpoints, 10 requests/min, 2,000/day
Builder	All endpoints, 100 requests/min, 20,000/day
Scale	All endpoints, 500 requests/min, 100,000/day
Enterprise	Custom

The free Hobby tier is limited to market-data endpoints; social, creator, and AI endpoints unlock on paid plans. Enterprise limits are custom — talk to sales.