reddit_ads_list_ads
List Reddit Ads
RedditDescription
List Reddit ads for an ad account. Shows configured status, delivery (effective) status, any rejection reason, parent campaign and ad group, and the click and post URLs.
Read-onlyIdempotentOpen-world
Usage
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "reddit_ads_list_ads",
"arguments": {}
}
}
hopkin reddit ads list
| Flag | Type | Required | Description |
|---|---|---|---|
--account | string | Required | Reddit ad account ID. |
--ad | string | Optional | Fetch a single ad by ID. |
--ad-ids | array | Optional | Fetch specific ads by IDs. |
--ad-group-id | string | Optional | Filter by parent ad group ID. |
--status | array | Optional | Filter by status. |
--limit | integer | Optional | |
--cursor | string | Optional | Opaque pagination cursor. |
--refresh | boolean | Optional | |
--connection-id | string | Optional | Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs. |
{
"mcpServers": {
"reddit-ads": {
"url": "https://reddit.mcp.hopkin.ai",
"transport": "sse"
}
}
}
No example prompts available.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
string |
Required | Reddit ad account ID.minLength: 1, maxLength: 64 |
reason |
string |
Required | Why this tool call is neededminLength: 1, maxLength: 500 |
Optional parameters (8)
| Name | Type | Required | Description |
|---|---|---|---|
ad_id |
string |
Optional | Fetch a single ad by ID.maxLength: 64 |
ad_ids |
array |
Optional | Fetch specific ads by IDs. |
ad_group_id |
string |
Optional | Filter by parent ad group ID.maxLength: 64 |
status |
array |
Optional | Filter by status. |
limit |
integer |
Optional | min: 1, max: 100 |
cursor |
string |
Optional | Opaque pagination cursor. |
refresh |
boolean |
Optional | |
connection_id |
string |
Optional | Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs. |