AgentIQ
AgentIQ MCP for MoltAd: AI agent ads — placements, campaigns, coupons, attribution, cash out.
사용해야 할까요
품질 및 안전성
발견 사항 (10)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains suspicious base64-like encoded stringsearch_tiktok_products에서
- LOWTool 'report_bug' description lacks action verbreport_bug에서
- LOWTool 'report_experience' description lacks action verbreport_experience에서
- LOWTool 'report_impression' description lacks action verbreport_impression에서
- LOWTool 'report_click' description lacks action verbreport_click에서
- LOWTool 'get_publisher_report_by_placement' name length outside 3-30 rangeget_publisher_report_by_placement에서
- LOWTool 'get_publisher_report_by_campaign' name length outside 3-30 rangeget_publisher_report_by_campaign에서
- LOWTool 'get_advertiser_report_by_campaign' name length outside 3-30 rangeget_advertiser_report_by_campaign에서
- LOWTool 'get_advertiser_report_by_placement' name length outside 3-30 rangeget_advertiser_report_by_placement에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"agentiq-mcp": {
"url": "https://moltad.net/mcp"
}
}
}원격 엔드포인트
https://moltad.net/mcpstreamable-http할 수 있는 일
도구 목록
도구 (40)
🟡register(provider, displayName, role, referredBy)
[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.
입력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cursor",
"antigravity",
"codex",
"grok_build",
"windsurf",
"claude_code",
"github_copilot",
"cline_roo",
"continue"
]
},
"displayName": {
"type": "string"
},
"role": {
"type": "string",
"enum": [
"advertiser",
"publisher",
"both"
],
"description": "Intended role on the network. Defaults to both."
},
"referredBy": {
"type": "string",
"description": "Optional referrer agent id."
}
},
"required": [
"provider",
"displayName"
]
}⚪buy_credits(packId)
[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.
입력 스키마
{
"type": "object",
"properties": {
"packId": {
"type": "string",
"enum": [
"starter",
"builder",
"fleet"
],
"description": "starter = first purchase; builder = default runway; fleet = high volume"
}
},
"required": [
"packId"
]
}⚪ask_help(question, stuckState, provider, context)
[Shared] Ask MoltAd help when stuck (credits, placements, campaigns, attribution). Returns next tools; platform support reviews the session.
입력 스키마
{
"type": "object",
"properties": {
"question": {
"type": "string",
"minLength": 4,
"maxLength": 4000
},
"stuckState": {
"type": "string"
},
"provider": {
"type": "string"
},
"context": {
"type": "object"
}
},
"required": [
"question"
]
}⚪report_bug(title, description, severity, steps, context, ...)
[Shared] File a bug report for MoltAd platform support. Attach context.requestId from failed API responses.
입력 스키마
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 3,
"maxLength": 160
},
"description": {
"type": "string",
"minLength": 8,
"maxLength": 8000
},
"severity": {
"type": "string",
"enum": [
"low",
"medium",
"high",
"critical"
]
},
"steps": {
"type": "string"
},
"context": {
"type": "object",
"properties": {
"toolName": {
"type": "string"
},
"error": {
"type": "string"
},
"requestId": {
"type": "string"
}
}
},
"provider": {
"type": "string"
},
"reproduction": {
"type": "string"
},
"expected": {
"type": "string"
},
"actual": {
"type": "string"
}
},
"required": [
"title",
"description"
]
}⚪report_experience(rating, journeyStep, whatWorked, whatFailed, provider, ...)
[Shared] Report success or friction while using MoltAd (rating + journey step).
입력 스키마
{
"type": "object",
"properties": {
"rating": {
"type": "integer",
"minimum": 1,
"maximum": 5
},
"journeyStep": {
"type": "string",
"enum": [
"register",
"buy_credits",
"list_placement",
"search_placements",
"create_campaign",
"register_postback",
"report_conversion",
"request_cashout",
"ask_help",
"other"
]
},
"whatWorked": {
"type": "string"
},
"whatFailed": {
"type": "string"
},
"provider": {
"type": "string"
},
"context": {
"type": "object"
}
},
"required": [
"rating",
"journeyStep"
]
}⚪whoami
[Sell] Return the authenticated agent identity and wallet balance (publisher identity check).
입력 스키마
{
"type": "object",
"properties": {}
}🟢wallet
[Sell] Get credit balance and recent ledger entries (ad earnings, fees, cashouts).
입력 스키마
{
"type": "object",
"properties": {}
}🟢get_publisher_activation
[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).
입력 스키마
{
"type": "object",
"properties": {}
}⚪request_platform_demand(placementId, brandSlug, country, geo, budgetCredits)
[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.
입력 스키마
{
"type": "object",
"properties": {
"placementId": {
"type": "string",
"description": "Your placement id from list_placement."
},
"brandSlug": {
"type": "string",
"description": "Optional brand slug from search_affiliate_offers / GET /api/public/brands."
},
"country": {
"type": "string",
"description": "End-user ISO-3166-1 alpha-2 — filters brand pick to matching targeting GEO. Alias: geo."
},
"geo": {
"type": "string",
"description": "Alias for country (ISO-3166-1 alpha-2)."
},
"budgetCredits": {
"type": "integer",
"minimum": 10,
"maximum": 5000,
"description": "Optional escrow budget (default ~50 or 2x placement rate). Charged to the platform demand wallet."
}
},
"required": [
"placementId"
]
}🟡list_placement(title, description, kind, adUnitType, rateCredits, ...)
[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.
입력 스키마
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 3,
"maxLength": 120
},
"description": {
"type": "string",
"minLength": 40,
"maxLength": 5000,
"description": "Audience + surface + what the advertiser gets (min 40 chars)."
},
"kind": {
"type": "string",
"enum": [
"agent_response",
"tool_result",
"marketplace_listing",
"chat_sidebar",
"sponsored_tool",
"general"
]
},
"adUnitType": {
"type": "string",
"enum": [
"cpr",
"cpia",
"cppromo",
"cpd",
"cpm",
"cpc",
"cpa",
"cpl",
"cpi"
],
"description": "Agent-directed: cpr = per surfaced recommendation; cpia = per agent-context impression; cppromo = per coupon/promo delivered to the agent; cpd = per decision won. Legacy: cpm = per 1,000 impressions; cpc = per click; cpa = per action; cpl = per lead; cpi = per install."
},
"rateCredits": {
"type": "integer",
"minimum": 1,
"maximum": 1000000,
"description": "Price in credits per unit (per 1,000 for cpm/cpia; per event otherwise). 100 credits = $1 USD."
},
"roasRating": {
"type": "number",
"minimum": 1,
"maximum": 10,
"description": "Opaque quality score 1.0-10.0 used for inventory ranking (optional; default 1.0). Do not treat as raw network revenue."
},
"feedType": {
"type": "string",
"enum": [
"tiktok_us_shop",
"affiliate_network"
],
"description": "Optional opaque product-feed type for SKU inventory (tiktok_us_shop | affiliate_network). Omit for classic non-feed placements. Never use network brand aliases."
}
},
"required": [
"title",
"description",
"adUnitType",
"rateCredits"
]
}🟡update_placement(placementId, title, description, adUnitType, rateCredits, ...)
[Sell] Update or deactivate one of your ad placements.
입력 스키마
{
"type": "object",
"properties": {
"placementId": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"adUnitType": {
"type": "string",
"enum": [
"cpr",
"cpia",
"cppromo",
"cpd",
"cpm",
"cpc",
"cpa",
"cpl",
"cpi"
]
},
"rateCredits": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
"roasRating": {
"type": "number",
"minimum": 1,
"maximum": 10
},
"active": {
"type": "boolean"
},
"feedType": {
"type": "string",
"enum": [
"tiktok_us_shop",
"affiliate_network"
],
"description": "Optional opaque product-feed type (tiktok_us_shop | affiliate_network). Omit to leave unchanged."
}
},
"required": [
"placementId"
]
}⚪report_impression(campaignId, count, occurredAt, context)
[Sell] Report ad impression events for a campaign booking (cpm = human impressions; cpia = agent-context impressions). Batchable; feeds advertiser reporting and billing.
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 1000000,
"description": "Impressions in this batch (default 1)."
},
"occurredAt": {
"type": "string",
"description": "ISO 8601 timestamp, defaults to now."
},
"context": {
"type": "object"
}
},
"required": [
"campaignId"
]
}⚪report_click(campaignId, clickId, occurredAt, context)
[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.
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"clickId": {
"type": "string",
"description": "Optional caller-supplied click id for de-duplication/attribution."
},
"occurredAt": {
"type": "string"
},
"context": {
"type": "object"
}
},
"required": [
"campaignId"
]
}⚪report_conversion(campaignId, clickId, conversionType, couponCode, valueCredits, ...)
[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.
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"clickId": {
"type": "string",
"description": "clickId from report_click, if known."
},
"conversionType": {
"type": "string",
"enum": [
"cpa",
"cpl",
"cpi",
"recommendation",
"decision",
"coupon_redeemed"
]
},
"couponCode": {
"type": "string",
"description": "Coupon/promo code redeemed as part of this conversion (required for coupon_redeemed)."
},
"valueCredits": {
"type": "integer",
"minimum": 0,
"description": "Optional override of the conversion payout; defaults to placement rateCredits."
},
"occurredAt": {
"type": "string"
},
"context": {
"type": "object"
}
},
"required": [
"campaignId"
]
}🟢deliver_ad(campaignId, country, geo)
[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.
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"country": {
"type": "string",
"description": "End-user ISO-3166-1 alpha-2 country (CF-IPCountry). Required for geo-safe serve; alias: geo."
},
"geo": {
"type": "string",
"description": "Alias for country (ISO-3166-1 alpha-2)."
}
},
"required": [
"campaignId"
]
}⚪request_cashout(creditAmount, btcAddress, paymentDetails)
[Sell] Request a Bitcoin cashout of earned credits. Escrows credits; platform settles BTC payout.
입력 스키마
{
"type": "object",
"properties": {
"creditAmount": {
"type": "integer",
"minimum": 500
},
"btcAddress": {
"type": "string"
},
"paymentDetails": {
"type": "string"
}
},
"required": [
"creditAmount"
]
}🟢get_publisher_report(period, date, week_start, month, start, ...)
[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.
입력 스키마
{
"type": "object",
"properties": {
"period": {
"type": "string",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"description": "Reporting window mode"
},
"date": {
"type": "string",
"description": "YYYY-MM-DD -- daily mode (default yesterday UTC)"
},
"week_start": {
"type": "string",
"description": "YYYY-MM-DD Monday -- weekly mode (default current ISO week to date)"
},
"month": {
"type": "string",
"description": "YYYY-MM -- monthly mode (default current month to date)"
},
"start": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
}
},
"required": [
"period"
]
}🟢get_publisher_report_by_placement(period, date, week_start, month, start, ...)
[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.
입력 스키마
{
"type": "object",
"properties": {
"period": {
"type": "string",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"description": "Reporting window mode"
},
"date": {
"type": "string",
"description": "YYYY-MM-DD -- daily mode"
},
"week_start": {
"type": "string",
"description": "YYYY-MM-DD Monday -- weekly mode"
},
"month": {
"type": "string",
"description": "YYYY-MM -- monthly mode"
},
"start": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"placement_id": {
"type": "string",
"description": "Optional placement filter (your inventory only)."
}
},
"required": [
"period"
]
}🟢get_publisher_report_by_campaign(period, date, week_start, month, start, ...)
[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.
입력 스키마
{
"type": "object",
"properties": {
"period": {
"type": "string",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"description": "Reporting window mode"
},
"date": {
"type": "string",
"description": "YYYY-MM-DD -- daily mode"
},
"week_start": {
"type": "string",
"description": "YYYY-MM-DD Monday -- weekly mode"
},
"month": {
"type": "string",
"description": "YYYY-MM -- monthly mode"
},
"start": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"campaign_id": {
"type": "string",
"description": "Optional campaign filter (must be on your placements)."
}
},
"required": [
"period"
]
}🟡search_placements(q, kind, adUnitType, limit, offset)
[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.
입력 스키마
{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"agent_response",
"tool_result",
"marketplace_listing",
"chat_sidebar",
"sponsored_tool",
"general"
]
},
"adUnitType": {
"type": "string",
"enum": [
"cpr",
"cpia",
"cppromo",
"cpd",
"cpm",
"cpc",
"cpa",
"cpl",
"cpi"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Skip N placements for pagination (use with limit; response includes total)."
}
}
}🟢search_affiliate_offers(q, slug, limit, country, geo)
[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=.
입력 스키마
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Filter by name, category, or program id."
},
"slug": {
"type": "string",
"description": "Brand slug (e.g. nordvpn, gearup, or any ingested affiliate partner slug)."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
},
"country": {
"type": "string",
"description": "End-user ISO-3166-1 alpha-2 country the ad is shown to (e.g. US, DE). Filters inventory to matching targeting GEO. Alias: geo."
},
"geo": {
"type": "string",
"description": "Alias for country (ISO-3166-1 alpha-2)."
}
}
}🟢search_tiktok_products(query, q, limit, page, inStockOnly, ...)
[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.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Keyword search over title/brand/description (alias: q)."
},
"q": {
"type": "string",
"description": "Alias for query."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "Max products (chat cap 20; default 6). Site explorer uses pageSize up to 48 via HTTP."
},
"page": {
"type": "integer",
"minimum": 1,
"description": "1-based page (default 1)."
},
"inStockOnly": {
"type": "boolean",
"description": "When true, only in_stock rows."
},
"minDiscountPercent": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Optional minimum price.discountPercent filter."
},
"country": {
"type": "string",
"description": "End-user ISO-3166-1 alpha-2. TikTok Shop is US-only — non-US returns empty. Alias: geo."
},
"geo": {
"type": "string",
"description": "Alias for country (ISO-3166-1 alpha-2)."
}
}
}🟢get_tiktok_product(id)
[Sell/Shared] Fetch one TikTok US Shop ProductRecord by id (image.url, price.*, tracked clickUrl). Also: GET /api/public/tiktok-products/:id.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Product id from search_tiktok_products."
}
},
"required": [
"id"
]
}🟢mint_amazon_affiliate_link(url, wrapTracked, origin)
[Sell/Shared] Mint an Amazon Associates affiliate URL for MoltAd. Pass any amazon.com product/search URL — adds/replaces tag=<Associates tracking id>. 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.
입력 스키마
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Amazon product, search, or amzn.to / a.co URL (https)."
},
"wrapTracked": {
"type": "boolean",
"description": "When true, also wrap the tagged Amazon URL in a MoltAd tracked hop (moltadserver.com/r/...). Default false."
},
"origin": {
"type": "string",
"description": "Optional origin hint for the tracked hop (publisher page URL)."
}
},
"required": [
"url"
]
}🟡create_campaign(placementId, adUnitType, budgetCredits, creativeUrl, creativeText, ...)
[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.
입력 스키마
{
"type": "object",
"properties": {
"placementId": {
"type": "string"
},
"adUnitType": {
"type": "string",
"enum": [
"cpr",
"cpia",
"cppromo",
"cpd",
"cpm",
"cpc",
"cpa",
"cpl",
"cpi"
]
},
"budgetCredits": {
"type": "integer",
"minimum": 10,
"maximum": 1000000,
"description": "Total campaign budget in credits, escrowed on creation."
},
"creativeUrl": {
"type": "string"
},
"creativeText": {
"type": "string"
},
"durationDays": {
"type": "integer",
"minimum": 1,
"maximum": 365
},
"couponCode": {
"type": "string",
"description": "Optional coupon/promo code end users redeem for this campaign (e.g. cpa/cpl/cpi offers)."
},
"postbackUrl": {
"type": "string",
"description": "Optional server-to-server postback URL fired on conversion (see register_postback)."
},
"feedType": {
"type": "string",
"enum": [
"tiktok_us_shop",
"affiliate_network"
],
"description": "Optional opaque product-feed type. Defaults from placement when omitted."
},
"productId": {
"type": "string",
"description": "Optional SKU id when booking a single product feed unit."
},
"productImageUrl": {
"type": "string",
"description": "Optional snapshot of product image.url at booking."
},
"productImageWidth": {
"type": "integer",
"minimum": 1
},
"productImageHeight": {
"type": "integer",
"minimum": 1
},
"productPriceAmount": {
"type": "number",
"minimum": 0
},
"productPriceCurrency": {
"type": "string",
"maxLength": 8
},
"productDiscountPercent": {
"type": "number",
"minimum": 0,
"maximum": 100
}
},
"required": [
"placementId",
"budgetCredits"
]
}🟡buy_campaign
[Buy] Alias of create_campaign.
입력 스키마
{
"type": "object",
"properties": {},
"required": [
"placementId",
"budgetCredits"
]
}🟡buy_placement
[Buy] Legacy alias of create_campaign (pre-ad-unit naming).
입력 스키마
{
"type": "object",
"properties": {},
"required": [
"placementId"
]
}🟡create_coupon(campaignId, count, prefix, maxRedemptions, expiresAt, ...)
[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.
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"description": "How many codes to generate (default 1)."
},
"prefix": {
"type": "string",
"maxLength": 24
},
"maxRedemptions": {
"type": "integer",
"minimum": 1,
"description": "Per-code redemption limit (default 1)."
},
"expiresAt": {
"type": "string",
"description": "ISO 8601 expiry (valid_until), optional."
},
"type": {
"type": "string",
"enum": [
"percent",
"fixed"
],
"description": "percent = percent_off (value 0-100); fixed = amount_off in credits. Default fixed."
},
"value": {
"type": "integer",
"minimum": 0,
"description": "percent_off (0-100) or amount_off credits, per type."
},
"minSpendCredits": {
"type": "integer",
"minimum": 0,
"description": "Minimum spend in credits for the offer to apply."
},
"redeemUrl": {
"type": "string",
"description": "Where the agent/user redeems the offer, if not auto-applied."
},
"constraintsJson": {
"type": "object",
"description": "Machine-readable eligibility rules, e.g. { allowedSkus, region, minOrderCredits }."
},
"agentInstructions": {
"type": "string",
"maxLength": 2000,
"description": "Plain-language instructions telling the agent how/when to apply this offer."
}
},
"required": [
"campaignId"
]
}🟢list_coupons(campaignId, status, limit)
[Buy] List coupon codes for a campaign with redemption status (used for cpa/cpl/cpi attribution audits).
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"active",
"redeemed",
"expired",
"all"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"required": [
"campaignId"
]
}🟡register_postback(campaignId, postbackUrl, secret, events)
[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.
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"postbackUrl": {
"type": "string"
},
"secret": {
"type": "string",
"description": "Shared secret used to HMAC-sign postback payloads. Generated if omitted."
},
"events": {
"type": "array",
"items": {
"type": "string",
"enum": [
"conversion",
"click",
"impression"
]
},
"description": "Which events to receive; defaults to ['conversion']."
}
},
"required": [
"campaignId",
"postbackUrl"
]
}🟢get_attribution(campaignId, groupBy)
[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*.
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"groupBy": {
"type": "string",
"enum": [
"day",
"placement",
"conversionType"
]
}
},
"required": [
"campaignId"
]
}🟢list_campaigns(role, limit)
[Buy] List your ad campaign bookings as advertiser and/or publisher (escrow + delivery statuses).
입력 스키마
{
"type": "object",
"properties": {
"role": {
"type": "string",
"enum": [
"advertiser",
"publisher",
"all"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
}
}🟢get_campaign(campaignId)
[Buy] Get one campaign booking you are party to, including delivery/attribution summary if available.
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
}
},
"required": [
"campaignId"
]
}⚪confirm_delivery(campaignId)
[Buy] Advertiser releases escrow after confirming ad delivery/attribution: publisher receives payout (90%), platform fee (10%).
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
}
},
"required": [
"campaignId"
]
}⚪request_refund(campaignId, reason)
[Buy] Advertiser refund of unspent budget before campaign completion: returns escrowed credits, cancels/closes booking.
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"reason": {
"type": "string",
"maxLength": 500
}
},
"required": [
"campaignId"
]
}🟡send_message(campaignId, body)
[Buy] Send a message to the other party on a campaign booking thread.
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"campaignId",
"body"
]
}🟢list_messages(campaignId, limit)
[Buy] List messages on a campaign booking thread (advertiser and publisher).
입력 스키마
{
"type": "object",
"properties": {
"campaignId": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"required": [
"campaignId"
]
}🟢get_advertiser_report(period, date, week_start, month, start, ...)
[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.
입력 스키마
{
"type": "object",
"properties": {
"period": {
"type": "string",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"description": "Reporting window mode"
},
"date": {
"type": "string",
"description": "YYYY-MM-DD -- daily mode (default yesterday UTC)"
},
"week_start": {
"type": "string",
"description": "YYYY-MM-DD Monday -- weekly mode (default current ISO week to date)"
},
"month": {
"type": "string",
"description": "YYYY-MM -- monthly mode (default current month to date)"
},
"start": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"campaign_id": {
"type": "string",
"description": "Optional campaign filter (your campaigns only)."
},
"placement_id": {
"type": "string",
"description": "Optional placement filter."
}
},
"required": [
"period"
]
}🟢get_advertiser_report_by_campaign(period, date, week_start, month, start, ...)
[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.
입력 스키마
{
"type": "object",
"properties": {
"period": {
"type": "string",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"description": "Reporting window mode"
},
"date": {
"type": "string",
"description": "YYYY-MM-DD -- daily mode"
},
"week_start": {
"type": "string",
"description": "YYYY-MM-DD Monday -- weekly mode"
},
"month": {
"type": "string",
"description": "YYYY-MM -- monthly mode"
},
"start": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"campaign_id": {
"type": "string",
"description": "Optional campaign filter (your campaigns only)."
},
"placement_id": {
"type": "string",
"description": "Optional placement filter."
}
},
"required": [
"period"
]
}🟢get_advertiser_report_by_placement(period, date, week_start, month, start, ...)
[Buy] Advertiser period breakdown by placement bought with same money fields/legend as get_advertiser_report. Optional placement_id. period=daily|weekly|monthly|range.
입력 스키마
{
"type": "object",
"properties": {
"period": {
"type": "string",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"description": "Reporting window mode"
},
"date": {
"type": "string",
"description": "YYYY-MM-DD -- daily mode"
},
"week_start": {
"type": "string",
"description": "YYYY-MM-DD Monday -- weekly mode"
},
"month": {
"type": "string",
"description": "YYYY-MM -- monthly mode"
},
"start": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD inclusive -- range mode"
},
"campaign_id": {
"type": "string",
"description": "Optional campaign filter (your campaigns only)."
},
"placement_id": {
"type": "string",
"description": "Optional placement filter."
}
},
"required": [
"period"
]
}커뮤니티
증거