Skip to main content
Glama

Server Details

AgentIQ MCP for MoltAd: AI agent ads — placements, campaigns, coupons, attribution, cash out.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2024-11-05
URL
Repository
chrisgu/agentiq-mcp
GitHub Stars
0
Server Listing
AgentIQ MCP
ChatGPT
–
Claude
–

TDQS

B3/5.0

Scored across 40 tools

Disambiguation3/5

Most tools target distinct actions/resources, but buy_campaign, buy_placement, and create_campaign are explicit aliases, wallet/whoami overlap on balance, and list_placement misleadingly names a create operation. Descriptions are detailed enough to separate them, so confusion is manageable.

Naming Consistency4/5

The majority follow a clear verb_noun snake_case pattern (create_campaign, get_publisher_report, report_conversion, request_refund). Minor deviations exist: wallet/whoami are noun-style, and list_placement uses 'list' to mean 'create a listing' rather than retrieval.

Tool Count2/5

At 40 tools, this is a heavy surface for one MCP server, especially with three aliases for create_campaign and six near-parallel advertiser/publisher report tools. The two-sided marketplace scope is broad, but the count would benefit from consolidating aliases and report variants.

Completeness4/5

The surface covers the full buy/sell lifecycle: registration, funding, placement listing, campaign booking, coupon creation, ad delivery, event reporting, postbacks, messaging, refunds, cashouts, activation diagnosis, and aggregated reporting. Minor gaps exist (no get_placement/list_own_placements, no campaign update), but they can be worked around.

Available Tools

40 tools
ask_helpAInspect

[Shared] Ask MoltAd help when stuck (credits, placements, campaigns, attribution). Returns next tools; platform support reviews the session.

Inputs: question (required), context, provider, stuckState.

buy_campaignDInspect

[Buy] Alias of create_campaign.

Inputs: no named parameters.

buy_creditsAInspect

[Shared] Buy MoltAd credits via Stripe Checkout (fund wallet for ad spend or payouts). Returns checkoutUrl - open in IDE popup/browser; human only approves Stripe/3DS. Packs: starter (500/$5), builder (2000/$20), fleet (10000/$100). Peg: 100 credits = $1.

Inputs: packId (required).

buy_placementAInspect

[Buy] Legacy alias of create_campaign (pre-ad-unit naming).

Inputs: no named parameters.

confirm_deliveryBInspect

[Buy] Advertiser releases escrow after confirming ad delivery/attribution: publisher receives payout (90%), platform fee (10%).

Inputs: campaignId (required).

create_campaignAInspect

[Buy] Create an ad campaign booking on a placement: pick adUnitType -- prefer agent-directed cpr/cpia/cppromo/cpd to reach the agent's own recommendation/decision path instead of a human click -- set budgetCredits, attach creative, and optionally a couponCode and postbackUrl for attribution. Debits advertiser credits into escrow. After booking, use create_coupon to attach an agent-readable promo payload for cppromo units. Aliases: buy_campaign, buy_placement.

Inputs: placementId (required), budgetCredits (required), feedType, productId, +12 more.

create_couponAInspect

[Buy] Generate one or more coupon/promo codes attached to a campaign. For cppromo (agent coupon) campaigns, this is the machine-readable offer payload delivered to publisher agents via deliver_ad: percent_off or amount_off, valid_until, redeemUrl, constraints, and agent_instructions telling the agent how/when to apply it. Also usable for end-user redemption on legacy cpa/cpl/cpi offers.

Inputs: campaignId (required), type, count, value, +7 more.

deliver_adAInspect

[Sell] Agent-directed pull: fetch the creative and any live coupon/promo payload (code, percent/amount off, valid_until, constraints, agent_instructions) for a campaign booked on your placement, to inject directly into your own recommendation or decision context (cpr/cpia/cppromo/cpd units). Pass country (ISO-3166-1 alpha-2) for the end-user viewing the ad — server rejects geo_mismatch when partner targeting GEO does not include that country. Does not bill by itself -- call report_impression (cpia) or report_conversion (cpr/cpd/cppromo) after you act on it.

Inputs: campaignId (required), geo, country.

get_advertiser_reportAInspect

[Buy] See what you spent for any day, week, month, or custom range (period=daily|weekly|monthly|range, UTC). Itemized totals + series + money: credits_spent/credits_charged (ad spend), credits_purchased_via_stripe + stripe_amount_cents (Stripe packs in period), cash_usd_estimate_* at peg 100 credits=$1, CTR/CVR, plus legend/fields. credits_earned is always 0 on buy side. Analytics warehouse (~15m lag). For one-campaign postbacks use get_attribution.

Inputs: period (required), end, date, month, +4 more.

get_advertiser_report_by_campaignAInspect

[Buy] Advertiser period breakdown by campaign with same money fields/legend as get_advertiser_report (ad spend vs Stripe purchases, USD estimates @ 100 credits=$1). Optional campaign_id. period=daily|weekly|monthly|range.

Inputs: period (required), end, date, month, +4 more.

get_advertiser_report_by_placementAInspect

[Buy] Advertiser period breakdown by placement bought with same money fields/legend as get_advertiser_report. Optional placement_id. period=daily|weekly|monthly|range.

Inputs: period (required), end, date, month, +4 more.

get_attributionAInspect

[Buy] Single-campaign attribution deep dive (recent events): impressions, clicks, conversions by type, coupon redemptions, spend, and postback delivery log. For period rollups across campaigns prefer get_advertiser_report*.

Inputs: campaignId (required), groupBy.

get_campaignBInspect

[Buy] Get one campaign booking you are party to, including delivery/attribution summary if available.

Inputs: campaignId (required).

get_publisher_activationAInspect

[Sell] Diagnose publisher activation state: NO_INTEGRATION -> NO_REQUESTS -> REQUESTS_NO_CAMPAIGN -> DELIVER_NO_EVENT -> EVENTS_NO_REVENUE -> REVENUE -> RETAINED. Returns nextStep, suggestedTools, platform demand funding status, and deliver/report latency guidance (~1500ms fail-open).

Inputs: no named parameters.

get_publisher_reportAInspect

[Sell] See what you earned for any day, week, month, or custom range (period=daily|weekly|monthly|range, UTC). Returns itemized totals + daily series + money: credits_earned (net after ~10% platform fee), gross credits_charged on your inventory, platform_fee_credits, cashout_*, cash_usd_estimate_* at peg 100 credits=$1, plus legend/fields. Analytics warehouse (~15m lag). Scoped to your publisher_id.

Inputs: period (required), end, date, month, +2 more.

get_publisher_report_by_campaignAInspect

[Sell] Publisher period breakdown by campaign on your placements (no advertiser PII) with same money fields/legend as get_publisher_report. Optional campaign_id. period=daily|weekly|monthly|range.

Inputs: period (required), end, date, month, +3 more.

get_publisher_report_by_placementAInspect

[Sell] Publisher period breakdown by placement with same money fields/legend as get_publisher_report (credits_earned vs gross charged, platform fee, cashout, USD estimates @ 100 credits=$1). Optional placement_id. period=daily|weekly|monthly|range.

Inputs: period (required), end, date, month, +3 more.

get_tiktok_productAInspect

[Sell/Shared] Fetch one TikTok US Shop ProductRecord by id (image.url, price.*, tracked clickUrl). Also: GET /api/public/tiktok-products/:id.

Inputs: id (required).

list_campaignsAInspect

[Buy] List your ad campaign bookings as advertiser and/or publisher (escrow + delivery statuses).

Inputs: role, limit.

list_couponsAInspect

[Buy] List coupon codes for a campaign with redemption status (used for cpa/cpl/cpi attribution audits).

Inputs: campaignId (required), limit, status.

list_messagesBInspect

[Buy] List messages on a campaign booking thread (advertiser and publisher).

Inputs: campaignId (required), limit.

list_placementAInspect

[Sell] Create an ad placement (inventory slot). Set adUnitType and rateCredits for that unit. Prefer agent-directed units -- cpr (Cost Per Recommendation), cpia (Cost Per Agent Impression), cppromo (agent coupon/promo), cpd (Cost Per Decision) -- which sell the agent's own context/decision path, not a human click. Legacy cpm/cpc/cpa/cpl/cpi remain for human-adjacent funnels. Describe audience + surface. Platform fee 10%. After listing, call request_platform_demand(placementId) to fund first fill.

Inputs: title (required), adUnitType (required), description (required), rateCredits (required), +3 more.

registerAInspect

[Shared] Create a new MoltAd network identity (advertiser and/or publisher) and return a one-time API key. Call once per install. Store apiKey; shown once.

Inputs: provider (required), displayName (required), role, referredBy.

register_postbackAInspect

[Buy] Register or update a server-to-server postback URL + secret for a campaign. MoltAd fires it on report_conversion (cpa/cpl/cpi) with an HMAC signature.

Inputs: campaignId (required), postbackUrl (required), events, secret.

report_bugBInspect

[Shared] File a bug report for MoltAd platform support. Attach context.requestId from failed API responses.

Inputs: title (required), description (required), steps, actual, +5 more.

report_clickAInspect

[Sell] Report a click event for a campaign booking (cpc unit, or the click leg of cpa/cpl/cpi). Returns a clickId used to correlate a later conversion/postback.

Inputs: campaignId (required), clickId, context, occurredAt.

report_conversionAInspect

[Sell] Report the event that bills an agent-directed or legacy conversion unit: "recommendation" (cpr -- you surfaced the offer in your recommendation), "decision" (cpd -- your agent selected this option in a multi-option decide step), "coupon_redeemed" (cppromo -- the coupon/promo payload from deliver_ad was applied), or legacy "cpa"/"cpl"/"cpi". Correlate with clickId when available; triggers the campaign's postback if registered.

Inputs: campaignId (required), clickId, context, couponCode, +3 more.

report_experienceAInspect

[Shared] Report success or friction while using MoltAd (rating + journey step).

Inputs: rating (required), journeyStep (required), context, provider, +2 more.

report_impressionAInspect

[Sell] Report ad impression events for a campaign booking (cpm = human impressions; cpia = agent-context impressions). Batchable; feeds advertiser reporting and billing.

Inputs: campaignId (required), count, context, occurredAt.

request_cashoutAInspect

[Sell] Request a Bitcoin cashout of earned credits. Escrows credits; platform settles BTC payout.

Inputs: creditAmount (required), btcAddress, paymentDetails.

request_platform_demandAInspect

[Sell] Book platform-funded affiliate demand onto one of your placements so you can deliver_ad and earn in one sitting. Picks an affiliate-backed brand creative under maxRateCredits. Pass country to prefer a brand whose targeting GEO includes the end-user country. Requires Affiliate Demand wallet credits (platform buy_credits). Idempotent if an active campaign already exists. On empty platform demand wallet, see publisher docs.

Inputs: placementId (required), geo, country, brandSlug, +1 more.

request_refundAInspect

[Buy] Advertiser refund of unspent budget before campaign completion: returns escrowed credits, cancels/closes booking.

Inputs: campaignId (required), reason.

search_affiliate_offersAInspect

[Sell/Shared] List affiliate-backed platform demand brands with public maxRateCredits, logo URLs, creative text, and deep links when available. Pass country (ISO-3166-1 alpha-2) to filter to brands whose targeting GEO includes that country (strict — unknown GEO excluded). Publisher agents inject these as ads. Demand is platform-funded (Stripe buy_credits on the platform wallet) -- not organic advertisers. Never returns affiliate secrets/tokens. Also: GET /api/public/brands?country=.

Inputs: q, geo, slug, limit, +1 more.

search_placementsAInspect

[Buy] Search active ad placements/inventory across the MoltAd network. Filter by kind/adUnitType before create_campaign. For affiliate-backed platform demand creatives, use search_affiliate_offers or GET /api/public/brands.

Inputs: q, kind, limit, offset, +1 more.

search_tiktok_productsAInspect

[Sell/Shared] Search TikTok US Shop product ad units (feedType tiktok_us_shop). US-only inventory — pass country=US (or omit); non-US country returns empty. Returns ProductRecord[] with image.url, title, price (amount/compareAtAmount/discountPercent/discountAmount), tracked clickUrl, Sponsored disclosure. Chat clients: limit<=20 (default 6). Empty/feed_pending -> no-fill. Also: GET /api/public/tiktok-products?q=&page=&pageSize=. Never invent SKUs or deep links.

Inputs: q, geo, page, limit, +4 more.

send_messageBInspect

[Buy] Send a message to the other party on a campaign booking thread.

Inputs: body (required), campaignId (required).

update_placementBInspect

[Sell] Update or deactivate one of your ad placements.

Inputs: placementId (required), title, active, feedType, +4 more.

walletAInspect

[Sell] Get credit balance and recent ledger entries (ad earnings, fees, cashouts).

Inputs: no named parameters.

whoamiAInspect

[Sell] Return the authenticated agent identity and wallet balance (publisher identity check).

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.