/
by ai.smithery
Manage Reddit advertising across accounts, campaigns, ad groups, posts, and ads. List accounts, fu…
Server configuration and capabilities from the MCP manifest
Size: 11,732 bytes (2,933 tokens)
Tools Found: 13
Analysis ID: btg4aatx
MCP server for Reddit ads management and subreddit analytics
Stars
Registry ID: a2b19133-66ab-4184-a31f-90b39887825f
Added to Registry: 9/21/2025
Last Updated: 9/22/2025
Last Seen: 9/22/2025
Default Branch: main
Last Push: 9/14/2025
Open Issues: 0
Historical performance and growth metrics over time
{
"name": "reddit-ads-mcp",
"tags": [
"reddit",
"ads",
"mcp",
"analytics"
],
"tools": [
{
"name": "getAdAccounts",
"description": "Get all available Reddit ad accounts for a business",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"businessId": {
"type": "string",
"description": "Reddit Business ID (optional if REDDIT_BUSINESS_ID env var is set)"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "getFundingInstruments",
"description": "Get all payment methods/funding instruments for an ad account",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"adAccountId": {
"type": "string",
"description": "Reddit ad account ID"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "getCampaigns",
"description": "Get all campaigns for an ad account",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"adAccountId": {
"type": "string",
"description": "Reddit ad account ID"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "getAdGroups",
"description": "Get all ad groups for an ad account",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"adAccountId": {
"type": "string",
"description": "Reddit ad account ID"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "getProfiles",
"description": "Get all Reddit profiles/accounts available for an ad account",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"adAccountId": {
"type": "string",
"description": "Reddit ad account ID"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "getPosts",
"description": "Get all posts for a specific Reddit profile",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"profileId": {
"type": "string",
"description": "Reddit profile ID"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "getPost",
"description": "Get details for a specific Reddit post",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"postId": {
"type": "string",
"description": "Reddit post ID"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "createCampaign",
"description": "Create a new Reddit advertising campaign",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Campaign name (3-200 characters)"
},
"appId": {
"type": "string",
"description": "App ID for app installs campaigns (Apple App Store or Google Play)"
},
"goalType": {
"enum": [
"LIFETIME_SPEND",
"DAILY_SPEND"
],
"type": "string",
"description": "Campaign goal type (requires CBO)"
},
"spendCap": {
"type": "number",
"description": "Campaign lifetime spend cap in microcurrency"
},
"goalValue": {
"type": "number",
"description": "Campaign level goal value in micros (requires CBO)"
},
"objective": {
"enum": [
"APP_INSTALLS",
"CATALOG_SALES",
"CLICKS",
"CONVERSIONS",
"IMPRESSIONS",
"LEAD_GENERATION",
"VIDEO_VIEWABLE_IMPRESSIONS"
],
"type": "string",
"description": "Campaign objective type"
},
"adAccountId": {
"type": "string",
"description": "Reddit ad account ID"
},
"ageRestriction": {
"enum": [
"ABOVE_18",
"ABOVE_21",
"NO_AGE_RESTRICTION"
],
"type": "string",
"default": "NO_AGE_RESTRICTION",
"description": "Age restriction for campaign"
},
"configuredStatus": {
"enum": [
"ACTIVE",
"ARCHIVED",
"DELETED",
"PAUSED"
],
"type": "string",
"default": "ACTIVE",
"description": "Campaign status"
},
"fundingInstrumentId": {
"type": "string",
"description": "Funding instrument ID for payment"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "createAdGroup",
"description": "Create a new Reddit ad group with targeting and bidding options",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"name": {
"type": "string",
"description": "Ad group name"
},
"appId": {
"type": "string",
"description": "App ID for app install campaigns"
},
"bidType": {
"enum": [
"CPC",
"CPM",
"CPV",
"CPV6"
],
"type": "string",
"description": "Bidding strategy type"
},
"endTime": {
"type": "string",
"description": "ISO 8601 timestamp when ad group ends"
},
"bidValue": {
"type": "number",
"minimum": 0,
"description": "Bid amount in microcurrency per event"
},
"goalType": {
"enum": [
"DAILY_SPEND",
"LIFETIME_SPEND"
],
"type": "string",
"description": "Type of goal"
},
"goalValue": {
"type": "number",
"minimum": 0,
"description": "Goal value in microcurrency"
},
"startTime": {
"type": "string",
"description": "ISO 8601 timestamp when ad group starts (e.g., 2025-09-18T22:27:10Z)"
},
"targeting": {
"type": "object",
"properties": {
"communities": {
"type": "array",
"items": {
"type": "string"
}
},
"geolocations": {
"type": "array",
"items": {
"type": "string"
}
},
"age_targeting": {
"type": "object",
"properties": {
"max_age": {
"type": "number",
"maximum": 65,
"minimum": 13
},
"min_age": {
"type": "number",
"maximum": 65,
"minimum": 13
}
}
}
}
},
"campaignId": {
"type": "string",
"description": "Campaign ID this ad group belongs to"
},
"adAccountId": {
"type": "string",
"description": "Reddit ad account ID"
},
"bidStrategy": {
"enum": [
"BIDLESS",
"MANUAL_BIDDING",
"MAXIMIZE_VOLUME",
"TARGET_CPX"
],
"type": "string",
"description": "Bid strategy"
},
"configuredStatus": {
"enum": [
"ACTIVE",
"ARCHIVED",
"DELETED",
"PAUSED"
],
"type": "string",
"default": "ACTIVE",
"description": "Ad group status"
},
"optimizationGoal": {
"enum": [
"PAGE_VISIT",
"VIEW_CONTENT",
"SEARCH",
"ADD_TO_CART",
"ADD_TO_WISHLIST",
"PURCHASE",
"LEAD",
"SIGN_UP",
"CLICKS",
"MOBILE_CONVERSION_INSTALL",
"MOBILE_CONVERSION_SIGN_UP",
"MOBILE_CONVERSION_ADD_PAYMENT_INFO",
"MOBILE_CONVERSION_ADD_TO_CART",
"MOBILE_CONVERSION_PURCHASE",
"MOBILE_CONVERSION_COMPLETED_TUTORIAL",
"MOBILE_CONVERSION_LEVEL_ACHIEVED",
"MOBILE_CONVERSION_SPEND_CREDITS",
"MOBILE_CONVERSION_REINSTALL",
"MOBILE_CONVERSION_UNLOCK_ACHIEVEMENT",
"MOBILE_CONVERSION_START_TRIAL",
"MOBILE_CONVERSION_SUBSCRIBE",
"MOBILE_CONVERSION_ONBOARD_STARTED",
"MOBILE_CONVERSION_FIRST_TIME_PURCHASE"
],
"type": "string",
"description": "Optimization goal for conversions"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "createPost",
"description": "Create a new Reddit post for advertising",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"body": {
"type": "string",
"maxLength": 40000,
"description": "Text content for text posts (max 40,000 characters)"
},
"type": {
"enum": [
"CAROUSEL",
"IMAGE",
"TEXT",
"VIDEO"
],
"type": "string",
"description": "Post type"
},
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"media_url": {
"type": "string",
"format": "uri",
"description": "Image/video media URL"
},
"display_url": {
"type": "string",
"description": "Display URL shown to users"
},
"call_to_action": {
"type": "string",
"description": "Call to action text (e.g., 'Learn More')"
},
"destination_url": {
"type": "string",
"format": "uri",
"description": "Destination URL when clicked"
}
}
},
"maxItems": 6,
"description": "Post content array (max 6 items for carousel, 1 for others)"
},
"headline": {
"type": "string",
"description": "Post title/headline"
},
"profileId": {
"type": "string",
"description": "Reddit profile ID (format: t2_xxxxx)"
},
"isRichtext": {
"type": "boolean",
"description": "Whether text post body is in richtext format"
},
"thumbnailUrl": {
"type": "string",
"format": "uri",
"description": "Thumbnail image URL (required for video posts)"
},
"allowComments": {
"type": "boolean",
"default": true,
"description": "Enable comments on the post"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "createAd",
"description": "Create a Reddit ad using the official Reddit Ads API",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"name": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Ad name (1-500 characters)"
},
"postId": {
"type": "string",
"pattern": "^t3_.*",
"description": "Reddit post ID to promote (format: t3_xxxxx)"
},
"clickUrl": {
"type": "string",
"maxLength": 5000,
"description": "Destination URL when ad is clicked (max 5000 characters)"
},
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product_id": {
"type": "string",
"description": "Product ID"
}
}
},
"description": "Products associated with the ad"
},
"adGroupId": {
"type": "string",
"description": "Ad group ID this ad belongs to"
},
"profileId": {
"type": "string",
"description": "Profile ID for catalog sales campaigns"
},
"campaignId": {
"type": "string",
"description": "Campaign ID this ad belongs to"
},
"adAccountId": {
"type": "string",
"description": "Reddit ad account ID"
},
"eventTrackers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "Tracking URL"
},
"type": {
"type": "string",
"description": "Event type (e.g., CLICK)"
}
}
},
"description": "Event tracking pixels from approved providers"
},
"previewExpiry": {
"type": "string",
"description": "ISO 8601 timestamp for preview URL expiry"
},
"profileUsername": {
"type": "string",
"description": "Profile username for catalog sales campaigns"
},
"configuredStatus": {
"enum": [
"ACTIVE",
"ARCHIVED",
"DELETED",
"PAUSED"
],
"type": "string",
"description": "Ad status"
},
"shoppingCreative": {
"type": "object",
"properties": {
"headline": {
"type": "string"
},
"allow_comments": {
"type": "boolean"
},
"call_to_action": {
"type": "string"
},
"destination_url": {
"type": "string",
"format": "uri"
},
"second_line_cta": {
"type": "string"
},
"dpa_carousel_mode": {
"type": "string"
}
}
},
"clickUrlQueryParams": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Query parameter name"
},
"value": {
"type": "string",
"description": "Query parameter value"
}
}
},
"maxItems": 14,
"description": "UTM parameters for click URL (max 14 items)"
},
"campaignObjectiveType": {
"enum": [
"APP_INSTALLS",
"CATALOG_SALES",
"CLICKS",
"CONVERSIONS",
"IMPRESSIONS",
"LEAD_GENERATION",
"VIDEO_VIEWABLE_IMPRESSIONS"
],
"type": "string",
"description": "Campaign objective type"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "getAds",
"description": "Get all ads from a Reddit ad account",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"adAccountId": {
"type": "string",
"description": "Reddit ad account ID"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
},
{
"name": "generateImage",
"description": "Generate an image from a text description using Google's Gemini Flash Image Preview",
"input_schema": {
"type": "object",
"required": [],
"properties": {
"style": {
"enum": [
"photorealistic",
"illustration",
"minimalist",
"artistic"
],
"type": "string",
"default": "photorealistic",
"description": "Style of the generated image"
},
"prompt": {
"type": "string",
"description": "Text description of the image to generate"
}
}
},
"output_schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
}
}
],
"version": "1.0.0",
"categories": [],
"description": "MCP server for Reddit ads management and subreddit analytics"
}Forks
Watchers
Contributors
Last Push: 9/14/2025
Open Issues: 0