list_campaigns
List Campaigns
Retrieve one page of campaigns for a selected ad account. Returns current configured state, relationships and provider values. Follow nextUrl to continue; a campaign status filter applies only to the returned page.
Ask your agent in plain language. Each of these maps to a real tool on the server.
list_campaigns
Retrieve one page of campaigns for a selected ad account. Returns current configured state, relationships and provider values. Follow nextUrl to continue; a campaign status filter applies only to the returned page.
send_conversion_events
Submit irreversible conversion events using deliberately selected CAPI v2 or v3. Preserves prehashed match keys and base-currency value. An HTTP acknowledgment is distinct from attribution or deduplication completion.
manage_ad
Create or update a Standard ad. Creation requires an explicit status; ACTIVE may enable advertising spend. ARCHIVED/DELETED are retained states, not history erasure. Current API constraints and account ownership are checked before writing.
get_account_info
Read the authenticated actor and exact ad account identity, currency, approval state and optional funding instruments. Use list_ad_accounts to discover account IDs.
manage_custom_audience
Create customer-list, website or engagement audiences using documented configuration. Existing audiences are readable, but metadata updates, description fields and lookalike creation are unsupported by this API.
list_custom_audiences
Retrieve one page of audiences for a selected ad account. Returns current provider state, size ranges and relationships. Follow nextUrl with the same account to continue.
manage_campaign
Create or update a Standard campaign. Creation requires an explicit status; ACTIVE may enable advertising spend. ARCHIVED/DELETED are retained states, not history erasure. Current API constraints and account ownership are checked before writing.
list_ad_groups
Retrieve one page of ad groups for a selected ad account, optionally filtered by campaign. Returns current configured state, relationships and provider values. Follow nextUrl with the same selectors to continue.
manage_audience_users
Submit hashed user rows for a selected customer-list audience. A 204 response acknowledges the request; it does not supply a processed-user count or prove completed matching.
list_ads
Retrieve one page of ads for a selected ad account, optionally filtered by ad group. Returns current configured state, relationships and provider values. Follow nextUrl with the same selectors to continue.
get_performance_report
Retrieve one page of campaign performance data with documented metrics and dimensions. YYYY-MM-DD dates become UTC midnight boundaries without extending endDate. Monetary metrics retain their provider units.
manage_ad_group
Create or update a Standard ad group. Creation requires an explicit status; ACTIVE may enable advertising spend. ARCHIVED/DELETED are retained states, not history erasure. Current API constraints and account ownership are checked before writing.
delete_custom_audience
Delete an exact custom audience after verifying its account association. The provider’s 204 acknowledgment does not assert erasure of historic advertising records.
list_ad_accounts
Discover authenticated actor and businesses, then supply businessId to query that business’s ad accounts. Returns one page; no account is selected automatically.
get_resource
Read one exact campaign, ad group, ad or custom audience and verify its account association. Includes provider state and relationships for independent write readback.
list_pixels
Discover one page of Pixels available to a selected advertising account for campaign measurement and conversion-event targeting.
list_targeting_options
Find targetable communities, interests or geolocations for ad-group targeting. Communities are searched by name or topic and paginated; interests and geolocations return one filtered list.
list_posts
Discover the profiles linked to an ad account, then list one page of a profile’s posts. Use a returned postId as the creative when creating an ad with manage_ad.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Discover Reddit advertising accounts and Pixels, manage Standard campaigns, ad groups and ads using existing creatives, read performance reports, create supported custom audiences, update customer-list membership and submit conversion events with explicit API-version and delivery effects.
Common questions about connecting Reddit Ads to AI agents with Metorial.