How to Connect Linkeddit to Claude AI as a Connector (Step-by-Step MCP Setup)
Give Claude direct access to Reddit search, lead databases, and user analysis. Set up the Linkeddit MCP connector in Claude.ai, Claude Desktop, Claude Code, Cursor, or VS Code in under five minutes.
Table of Contents
What Is MCP (Model Context Protocol)?
The Model Context Protocol (MCP) is an open standard created by Anthropic that lets AI assistants connect to external tools and data sources in real time. Think of it as a USB port for AI: any MCP-compatible server can plug into any MCP-compatible client, giving the AI live access to data it would otherwise never see.
Without MCP, asking Claude about Reddit data means copying and pasting text manually. With MCP, Claude can directly search Reddit, pull subreddit posts, read comments, look up user profiles, and query your Linkeddit lead database -- all within the same conversation.
Why This Matters for Lead Generation:
MCP turns Claude into an active research assistant. Instead of switching between tabs, you ask Claude to find high-intent Reddit users, analyze their post history, and draft personalized outreach -- all in one workflow. Linkeddit's MCP server makes this possible with 9 purpose-built tools.
Linkeddit exposes a remote MCP server at https://linkeddit.com/api/mcp/reddit/mcp using the Streamable HTTP transport. This means there is nothing to install locally. Your AI client connects to the server over HTTPS, authenticates with your credentials, and gains access to all 9 tools.
The 9 Linkeddit MCP Tools
The Linkeddit MCP server provides two categories of tools: four Reddit data tools that fetch live data from Reddit, and five Linkeddit database tools that query your lead pipeline.
Reddit Data Tools (Live)
Search Reddit posts across all subreddits. Supports sort by relevance, hot, top, new, or comments. Filter by time range (hour, day, week, month, year, all). Returns post titles, scores, comment counts, URLs, and full text content.
Fetch posts from a specific subreddit. Sort by hot, new, top, or rising. Useful for monitoring target subreddits for buying signals, competitor mentions, or industry trends.
Given a full Reddit post URL, fetch the post body and its top-level comments. Control the number of comments returned (up to 50). Ideal for reading discussion threads and identifying engaged users.
A flexible tool that fetches any Reddit JSON endpoint. Pass a path like /r/SaaS/top.json?t=week for custom queries that the other tools do not cover.
Linkeddit Database Tools
Search your Linkeddit leads database for Reddit users identified as potential leads. Filter by subreddit, lead status (new, contacted, responded, qualified, converted), and minimum contactability score (0-100).
Look up a detailed Reddit user profile from the Linkeddit database. Returns karma, post count, comment count, identified niches, tags, and a contactability score.
Retrieve Reddit posts by a specific user stored in the Linkeddit database. Optionally filter by subreddit. Useful for understanding what a lead talks about and where.
Retrieve Reddit comments by a specific user. Filter by subreddit to see their activity in your target communities. Helps gauge expertise level and engagement style.
Get AI-generated insights about a Reddit user, including expertise level, identified niches, behavioral tags, and a description derived from their Reddit activity. The highest-signal tool for qualifying leads.
Prerequisites: Get Your API Credentials
Before connecting any client, you need a Linkeddit account with an active Pro membership and a set of MCP API credentials.
Step-by-Step Credential Setup:
lnkd_ and your Client Secret starts with lnkd_sec_. The secret is only shown once.Security Note:
Linkeddit stores a SHA-256 hash of your Client Secret, not the plaintext. If you lose it, you will need to generate a new credential pair. Never share your secret in public repositories or chat logs.
Setup: Claude.ai (Web)
Claude.ai supports remote MCP servers natively through its Integrations feature. This is the fastest way to get started since there is no config file to edit.
Steps:
https://linkeddit.com/api/mcp/reddit/mcp
Once connected, you will see a tools icon in the Claude.ai chat input area. Click it to verify the Linkeddit tools are listed before starting a conversation.
Setup: Claude Desktop
Claude Desktop reads MCP server configurations from a JSON file on your machine. You need to edit this file once, then restart the app.
Config File Location:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Add This Configuration:
{
"mcpServers": {
"linkeddit": {
"url": "https://linkeddit.com/api/mcp/reddit/mcp",
"headers": {
"X-Client-Id": "lnkd_your_client_id_here",
"X-Client-Secret": "lnkd_sec_your_client_secret_here"
}
}
}
}"linkeddit" inside the existing mcpServers object.Setup: Claude Code (CLI)
Claude Code is Anthropic's command-line interface for Claude. It supports MCP servers through its claude mcp add command.
Run This Command:
claude mcp add linkeddit \ --transport streamable-http \ --url https://linkeddit.com/api/mcp/reddit/mcp \ --header "X-Client-Id: lnkd_your_client_id_here" \ --header "X-Client-Secret: lnkd_sec_your_client_secret_here"
That is it. The next time you start a Claude Code session, the Linkeddit tools will be available. You can verify with claude mcp list to see all registered servers.
Setup: Cursor
Cursor supports MCP servers through its settings UI or by editing the project-level .cursor/mcp.json file.
Option A: Settings UI
1. Open Cursor Settings (Cmd+Shift+J on macOS, Ctrl+Shift+J on Windows).
2. Navigate to MCP in the sidebar.
3. Click "Add new MCP server".
4. Set the type to streamable-http, name it linkeddit, and paste the server URL.
Option B: Config File
Create or edit .cursor/mcp.json in your project root:
{
"mcpServers": {
"linkeddit": {
"url": "https://linkeddit.com/api/mcp/reddit/mcp",
"headers": {
"X-Client-Id": "lnkd_your_client_id_here",
"X-Client-Secret": "lnkd_sec_your_client_secret_here"
}
}
}
}After saving, Cursor will detect the new server automatically. You can use Linkeddit tools in Cursor's Agent mode and Composer.
Setup: VS Code
VS Code supports MCP servers through the GitHub Copilot extension (agent mode) or via the .vscode/mcp.json file in your workspace.
Workspace Config (.vscode/mcp.json):
{
"servers": {
"linkeddit": {
"type": "http",
"url": "https://linkeddit.com/api/mcp/reddit/mcp",
"headers": {
"X-Client-Id": "lnkd_your_client_id_here",
"X-Client-Secret": "lnkd_sec_your_client_secret_here"
}
}
}
}Alternatively, open VS Code Settings (JSON) and add the server under mcp.servers. After saving, the tools will be available in Copilot Chat when using agent mode.
Example Prompts to Try
Once connected, you can use natural language to invoke the tools. Claude decides which tool to call based on your prompt. Here are some high-value prompts to get started:
"Search Reddit for posts about people looking for CRM software in r/smallbusiness and r/SaaS from the last month. Summarize the top 10 results and identify which users seem ready to buy."
"Get the profile and lead insights for Reddit user u/example_user. What are their main interests and how likely are they to convert?"
"Fetch the top posts from r/entrepreneur this week. Which ones show buying intent or mention needing a tool or service?"
"Fetch the comments on this Reddit post: [URL]. Identify commenters who are asking questions about pricing or requesting recommendations."
"Search my Linkeddit leads for anyone in the marketing automation niche with a contactability score above 70. Show me the top 10."
"Get the recent posts and comments for u/example_user, then draft a personalized Reddit DM that references their specific pain points."
Pro Tip:
Chain multiple tools in a single prompt. For example: "Search r/SaaS for posts about email marketing tools, then for the top 3 most engaged commenters, get their lead insights." Claude will call the tools sequentially and synthesize the results.
Rate Limits and Usage
Linkeddit enforces rate limits to ensure fair usage and server stability. These limits apply per user across all connected clients.
Current Limits:
If you exceed a rate limit, the server returns an error with a retry-after value. Claude will surface this in the conversation and can retry automatically after the cooldown period.
For most lead generation workflows, 1,000 daily calls is more than sufficient. A typical research session uses 10-30 tool calls. Heavy automation or scripting may require batching requests across multiple days.
Frequently Asked Questions
What is the Model Context Protocol (MCP)?
MCP is an open standard created by Anthropic that allows AI assistants like Claude to connect to external tools and data sources. It works like a USB port for AI -- any MCP-compatible server can plug into any MCP-compatible client, giving the AI access to real-time data and actions. Linkeddit implements an MCP server that exposes Reddit search and lead database tools.
Do I need a paid Linkeddit plan to use the MCP connector?
Yes. MCP access requires a Linkeddit Pro membership. Once subscribed, you can generate API credentials from the credential management page and connect to any supported client. View available plans on the pricing page.
What are the rate limits for Linkeddit MCP tools?
Linkeddit MCP enforces two rate limits: 1,000 tool calls per day and 30 tool calls per minute per user. These limits apply across all connected clients. If you exceed them, the server returns a retry-after value so your client knows when to resume. The database tools (search_leads, get_user_profile, etc.) and the Reddit tools (search_reddit, fetch_subreddit, etc.) share the same quota.
Can I use Linkeddit MCP with clients other than Claude?
Yes. Linkeddit MCP uses the Streamable HTTP transport, which is supported by any MCP-compatible client. This includes Claude.ai, Claude Desktop, Claude Code, Cursor, Windsurf, VS Code with the Copilot MCP extension, and any custom client built on the MCP SDK. Any tool that speaks the MCP protocol over HTTP can connect to the Linkeddit server.
How do I troubleshoot connection issues with the Linkeddit MCP server?
First, verify your credentials are correct and active at linkeddit.com/mcp/keys. Check that your Client ID starts with lnkd_ and your Client Secret starts with lnkd_sec_. Ensure you have an active Pro membership. If using Claude Desktop, restart the app completely after editing the config file. For persistent issues, check that your network allows outbound HTTPS connections to linkeddit.com.
Ready to Connect Linkeddit to Claude?
Get your API credentials and start using all 9 Linkeddit tools inside Claude in under five minutes. Turn Claude into a Reddit lead generation research assistant.