Model Context Protocol

MCP Server

Connect your AI assistant directly to Reddit Search API. Search millions of Reddit conversations, explore subreddits, and discover trends — all through natural language.

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. Instead of copying and pasting data, your AI can directly access and analyze information in real-time.

With our MCP server, any compatible AI client gains the ability to search Reddit's vast conversation database, explore communities, and surface trending topics — all through natural conversation.

Quick Setup

Get Your API Key

Add Server Configuration

Add the following MCP server configuration to your AI client. The config format works with Claude Desktop, Cursor, Windsurf, and other MCP-compatible clients:

{
  "mcpServers": {
    "reddit-search-api": {
      "transport": {
        "type": "http",
        "url": "https://reddapi.dev/api/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

Replace YOUR_API_KEY with your actual API key. Refer to your client's documentation for the config file location.

Restart Your Client

After saving the configuration file, restart your AI client. The Reddit Search API tools will now be available in your conversations.

Compatible Clients

Works with any MCP-compatible client including Claude Desktop, Cursor, Windsurf, Cline, and more. Check modelcontextprotocol.io for a full list of supported clients.

Authentication

The MCP server requires an API key to execute tools. Without a valid API key, you can connect and view available tools, but tool execution will fail.

How to Get Your API Key

Subscribe to a paid plan (API access requires a paid subscription)

Go to your Account Dashboard

Find the API Key section and click "Generate API Key"

Copy the key and replace YOUR_API_KEY in your MCP client configuration

Keep Your API Key Secret

Never share your API key publicly or commit it to version control. If you believe your key has been compromised, regenerate it immediately from your account dashboard.

Error Without Authentication

If you try to use MCP tools without a valid API key, you'll see this error:

{
  "error": {
    "code": -32001,
    "message": "Authentication required. Please provide a valid API key..."
  }
}

Available Tools

Once connected, your AI assistant will have access to these tools for searching and exploring Reddit:

TOOL reddit_semantic_search (Requires API key)

AI-powered semantic search. Extracts keywords via LLM, performs vector search, and generates an AI summary. Slower but more comprehensive.

Parameters

Name	Type	Required	Description
query	string	Yes	Natural language search query
limit	number	No	Number of results (default: 20, max: 100)

Example prompt: "What do developers think about Rust vs Go for backend services?"

TOOL reddit_vector_search (Requires API key)

Fast vector similarity search. Directly converts query to embeddings and finds similar posts. No LLM processing, much faster.

Parameters

Name	Type	Required	Description
query	string	Yes	Search query
limit	number	No	Number of results (default: 30, max: 30)

Example prompt: "Find posts about mechanical keyboards for programming"

TOOL reddit_list_subreddits (Requires API key)

Get a paginated list of available subreddits with metadata.

Parameters

Name	Type	Required	Description
page	number	No	Page number (default: 1)
limit	number	No	Results per page (default: 20, max: 100)
search	string	No	Search filter for subreddit name/title/description

Example prompt: "List all programming-related subreddits"

TOOL reddit_get_subreddit (Requires API key)

Get detailed information about a specific subreddit.

Parameters

Name	Type	Required	Description
subreddit	string	Yes	Subreddit name (without r/ prefix)

Example prompt: "Get details about the typescript subreddit"

TOOL reddit_get_trends (Requires API key)

Get trending keywords from Reddit, sorted by popularity.

Parameters

Name	Type	Required	Description
page	number	No	Page number (default: 1)
limit	number	No	Results per page (default: 12, max: 50)
filter	string	No	Time filter - "latest", "today", "week", "month"
category	string	No	Category filter (e.g. Technology, Health, Sports)

Example prompt: "What's trending in tech on Reddit this week?"

Usage Examples

Research a Topic

You: What are developers saying about React Server Components?

AI: Let me search Reddit for discussions about React Server Components.

[Uses reddit_semantic_search tool]

Found 45 results for "React Server Components developer opinions"

Keywords: react, server components, next.js, performance, ssr

AI Summary:
Developers generally praise RSC for performance benefits in large applications...
Some express concerns about the learning curve and tooling complexity...

Top Results:

1. React Server Components: A year in production
   r/webdev | 1247 upvotes | 89 comments
   Relevance: 94.3%

Explore a Subreddit

You: Tell me about the r/typescript community

AI: [Uses reddit_get_subreddit tool]

r/typescript - TypeScript
Subscribers: 285,432
Created: 2012-10-01

Description: A community for discussing TypeScript, a typed superset...

Recent Posts:

1. TypeScript 5.4 released with new features
   567 upvotes | 45 comments

2. Help: How to type this complex nested object?
   234 upvotes | 12 comments

Find Trending Topics

You: What's trending in tech on Reddit this week?

AI: [Uses reddit_get_trends tool with filter "week"]

Reddit Trends (Filter: week, Category: technology)
Page 1 of 3, Total: 28 articles

1. AI Coding Assistants: Are They Replacing Junior Developers?
   By Sarah Chen | technology
   Published: 2024-01-15 | Views: 12,453
   Tags: ai, coding, career, tools

Technical Details

Protocol

MCP Streamable HTTP Transport (2025-11-25)

Endpoint

https://reddapi.dev/api/mcp

HTTP Methods

Method	Purpose
POST	Handles client JSON-RPC requests
GET	Opens SSE stream for server messages
DELETE	Terminates sessions

Troubleshooting

Tools not showing up

Check that your config file has valid JSON syntax. Try copying the configuration exactly as shown above. Restart your AI client completely (quit and reopen).