Reddit Ads MCP Server

by mkerchenskiio.github.mkerchenski/reddit-ads-mcpv1.1.1

MCP server for the Reddit Ads API. List accounts, campaigns, ads, and pull reports.

1.NETstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale8mo ago

Install Reddit Ads MCP server

claude mcp add redditads -e REDDIT_CLIENT_ID='<reddit-client-id>' -e REDDIT_CLIENT_SECRET='<reddit-client-secret>' -e REDDIT_REFRESH_TOKEN='<reddit-refresh-token>' -e REDDIT_ACCOUNT_ID='<reddit-account-id>' -- dnx RedditAdsMcp --yes

{
  "mcpServers": {
    "redditads": {
      "command": "dnx",
      "args": [
        "RedditAdsMcp",
        "--yes"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "<reddit-client-id>",
        "REDDIT_CLIENT_SECRET": "<reddit-client-secret>",
        "REDDIT_REFRESH_TOKEN": "<reddit-refresh-token>",
        "REDDIT_ACCOUNT_ID": "<reddit-account-id>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "redditads": {
      "command": "dnx",
      "args": [
        "RedditAdsMcp",
        "--yes"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "<reddit-client-id>",
        "REDDIT_CLIENT_SECRET": "<reddit-client-secret>",
        "REDDIT_REFRESH_TOKEN": "<reddit-refresh-token>",
        "REDDIT_ACCOUNT_ID": "<reddit-account-id>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "redditads": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "RedditAdsMcp",
        "--yes"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "<reddit-client-id>",
        "REDDIT_CLIENT_SECRET": "<reddit-client-secret>",
        "REDDIT_REFRESH_TOKEN": "<reddit-refresh-token>",
        "REDDIT_ACCOUNT_ID": "<reddit-account-id>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "redditads": {
      "command": "dnx",
      "args": [
        "RedditAdsMcp",
        "--yes"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "<reddit-client-id>",
        "REDDIT_CLIENT_SECRET": "<reddit-client-secret>",
        "REDDIT_REFRESH_TOKEN": "<reddit-refresh-token>",
        "REDDIT_ACCOUNT_ID": "<reddit-account-id>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
REDDIT_CLIENT_ID	yes	—	Reddit app client ID
REDDIT_CLIENT_SECRET	yes	yes	Reddit app client secret
REDDIT_REFRESH_TOKEN	yes	yes	OAuth refresh token
REDDIT_ACCOUNT_ID	yes	—	Default Reddit ad account ID

Freshness

Stale — last maintenance signal 8mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-02-21 · 8mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-02-21 · 8mo ago · official registry · v1.1.1

FAQ

›How do I install the Reddit Ads MCP server in Claude Code?

Run: claude mcp add redditads -e REDDIT_CLIENT_ID='<reddit-client-id>' -e REDDIT_CLIENT_SECRET='<reddit-client-secret>' -e REDDIT_REFRESH_TOKEN='<reddit-refresh-token>' -e REDDIT_ACCOUNT_ID='<reddit-account-id>' -- dnx RedditAdsMcp --yes. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Reddit Ads require an API key?

Yes. It expects REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_REFRESH_TOKEN, REDDIT_ACCOUNT_ID, of which 2 are secrets.

›Can I use Reddit Ads as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Reddit Ads in the official MCP registry?

Yes, as io.github.mkerchenski/reddit-ads-mcp.