AgentIQ
Server Details
AgentIQ MCP for MoltAd: AI agent ads — placements, campaigns, coupons, attribution, cash out.
- 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
Scored across 40 tools
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.
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.
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.
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 toolsask_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.
mint_amazon_affiliate_linkAInspect
[Sell/Shared] Mint an Amazon Associates affiliate URL for MoltAd. Pass any amazon.com product/search URL — adds/replaces tag=. SiteStripe short links (amzn.to / a.co) pass through unchanged (tracking already embedded). Optional wrapTracked=true mints a MoltAd /r hop on moltadserver.com. Always surface the returned disclosure to end users. Also: GET/POST /api/public/amazon-affiliate-link. PA-API product search is a follow-up; tag rewrite is enough to earn.
Inputs: url (required), origin, wrapTracked.
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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Website monetization for AI agents: apply, integrate ads, reporting, and payouts — all over MCP.
MCP-native ad server. Monetize AI chatbots and agents with conversational ads.
AI agents that manage paid ads on Meta, LinkedIn, and Google Ads from any MCP client.
AdCP sales agent. AI agents find inventory, create ads and run campaigns. People approve.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for AI agents to manage ad campaigns across Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, and more21210 npm21MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for buying advertising outcomes such as Telegram subscribers and website traffic from a prepaid balance. Provides tools for campaign management, forecasting, and budget control, with guardrails so agents can spend but not fund or withdraw.MIT
- AlicenseCqualityBmaintenanceAgent Commerce Payments - MCP server providing AI-powered tools and automation by MEOK AI Labs56 npm149 PyPIMIT
- AlicenseAqualityBmaintenanceVendor-neutral MCP server that discovers, routes, and attributes revenue across paid APIs, referral links, and affiliate programs for agent tools.897 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.