SystemPrompt

v1.0.0Communicationstable

A production-ready Model Context Protocol server that integrates with Reddit, demonstrating complete MCP specification with OAuth 2.1, sampling, elicitation, structured data validation, and real-time notifications.

mcpmcp-serverredditsystempromptsystempromptio
Share:
102
Stars
0
Downloads
0
Weekly
0/5

What is SystemPrompt?

SystemPrompt is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to production-ready model context protocol server that integrates with reddit, demonstrating complete mcp specification with oauth 2.1, sampling, elicitation, structured data validation, and real-time no...

A production-ready Model Context Protocol server that integrates with Reddit, demonstrating complete MCP specification with OAuth 2.1, sampling, elicitation, structured data validation, and real-time notifications.

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A production-ready Model Context Protocol server that integr

Use Cases

Integrate Reddit with AI assistants using production-ready OAuth 2.1. Access Reddit content with real-time notifications and structured data validation.
systempromptio

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedApr 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx systemprompt

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use SystemPrompt

systemprompt-mcp-server is a production-ready MCP server that integrates AI assistants with Reddit, implementing the full MCP specification including OAuth 2.1 authentication, sampling for AI-assisted content generation, elicitation, structured data validation, and real-time notifications. It exposes tools for searching Reddit, fetching posts and comments, and receiving notifications, making it useful both as a functional Reddit integration and as a reference implementation for developers building standards-compliant MCP servers. Engineers can use it to let Claude browse and interact with Reddit content through a properly secured, spec-complete protocol layer.

Prerequisites

  • Node.js 18+ (for running via npx or global install)
  • A Reddit account with an OAuth 2.0 app registered at reddit.com/prefs/apps
  • REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET from the Reddit app credentials
  • A JWT_SECRET for signing server-issued tokens
  • An MCP-compatible client such as Claude Desktop
1

Create a Reddit OAuth app

Go to reddit.com/prefs/apps, click 'create another app', choose 'web app', and note the client ID (under the app name) and client secret.

2

Install the server

Install globally via npm or use npx for a no-install run.

npm install -g @systemprompt/systemprompt-mcp-server
3

Create a .env file with credentials

Create a .env file in your working directory with the Reddit and JWT configuration.

REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret
JWT_SECRET=a_long_random_secret_string
REDDIT_USER_AGENT=mcp-reddit-bot/1.0 by u/yourusername
REDDIT_USERNAME=yourusername
PORT=3000
4

Start the server

Run the server. It will listen on the configured PORT (default 3000) and expose the MCP endpoint.

npx @systemprompt/systemprompt-mcp-server
5

Add to Claude Desktop config

Register the server in claude_desktop_config.json with the required environment variables so Claude Desktop can launch it automatically.

{
  "mcpServers": {
    "systemprompt-reddit": {
      "command": "npx",
      "args": ["-y", "@systemprompt/systemprompt-mcp-server"],
      "env": {
        "REDDIT_CLIENT_ID": "your_reddit_client_id",
        "REDDIT_CLIENT_SECRET": "your_reddit_client_secret",
        "JWT_SECRET": "a_long_random_secret_string",
        "REDDIT_USER_AGENT": "mcp-reddit-bot/1.0 by u/yourusername",
        "REDDIT_USERNAME": "yourusername"
      }
    }
  }
}

SystemPrompt Examples

Client configuration

claude_desktop_config.json entry for the systemprompt Reddit MCP server using npx.

{
  "mcpServers": {
    "systemprompt-reddit": {
      "command": "npx",
      "args": ["-y", "@systemprompt/systemprompt-mcp-server"],
      "env": {
        "REDDIT_CLIENT_ID": "your_reddit_client_id",
        "REDDIT_CLIENT_SECRET": "your_reddit_client_secret",
        "JWT_SECRET": "a_long_random_secret_string",
        "REDDIT_USER_AGENT": "mcp-reddit-bot/1.0 by u/yourusername",
        "REDDIT_USERNAME": "yourusername"
      }
    }
  }
}

Prompts to try

Example prompts that exercise the Reddit MCP server tools.

- "Search Reddit for recent posts about Model Context Protocol and summarise the top discussions."
- "Get the top posts from r/MachineLearning this week."
- "Fetch the comments on this Reddit post and find the most upvoted reply."
- "Check my Reddit notifications and show me any new replies to my posts."
- "Find posts in r/programming about Rust and filter for those with more than 500 upvotes."

Troubleshooting SystemPrompt

Reddit API returns 401 or 'invalid_grant' during OAuth flow

Double-check REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET. Ensure the redirect URI in your Reddit app settings matches the one the server uses. Also confirm the app type is 'web app', not 'installed app'.

Server starts but Claude Desktop cannot connect

Verify the server is listening on the expected port by running `curl http://localhost:3000`. If it is, check that the PORT env var matches what the MCP client is configured to reach. For stdio transport, ensure the command in the config launches the server correctly.

REDDIT_USER_AGENT causes 429 Too Many Requests

Reddit enforces rate limits per user agent. Use a descriptive, unique user agent string in the format 'platform:appname:version by u/username'. Avoid generic strings like 'bot' or 'test'.

Frequently Asked Questions about SystemPrompt

What is SystemPrompt?

SystemPrompt is a Model Context Protocol (MCP) server that production-ready model context protocol server that integrates with reddit, demonstrating complete mcp specification with oauth 2.1, sampling, elicitation, structured data validation, and real-time notifications. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install SystemPrompt?

Follow the installation instructions on the SystemPrompt GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with SystemPrompt?

SystemPrompt works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is SystemPrompt free to use?

Yes, SystemPrompt is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "systemprompt": { "command": "npx", "args": ["-y", "systemprompt"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use SystemPrompt?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides