Server definition
- Hash
- sha256:24c6c57c4a8304676f72159593773a5273ffa92dfc6b29741ae6f5e2b6a984c8
- What it is
- What a remote MCP server returned when asked what it offers: 40 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "[Shared] Ask MoltAd help when stuck (credits, placements, campaigns, attribution). Returns next tools; platform support reviews the session.",
"inputSchema": {
"properties": {
"context": {
"type": "object"
},
"provider": {
"type": "string"
},
"question": {
"maxLength": 4000,
"minLength": 4,
"type": "string"
},
"stuckState": {
"type": "string"
}
},
"required": [
"question"
],
"type": "object"
},
"name": "ask_help",
"outputSchema": null
},
{
"description": "[Buy] Alias of create_campaign.",
"inputSchema": {
"properties": {},
"required": [
"placementId",
"budgetCredits"
],
"type": "object"
},
"name": "buy_campaign",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"packId": {
"description": "starter = first purchase; builder = default runway; fleet = high volume",
"enum": [
"starter",
"builder",
"fleet"
],
"type": "string"
}
},
"required": [
"packId"
],
"type": "object"
},
"name": "buy_credits",
"outputSchema": null
},
{
"description": "[Buy] Legacy alias of create_campaign (pre-ad-unit naming).",
"inputSchema": {
"properties": {},
"required": [
"placementId"
],
"type": "object"
},
"name": "buy_placement",
"outputSchema": null
},
{
"description": "[Buy] Advertiser releases escrow after confirming ad delivery/attribution: publisher receives payout (90%), platform fee (10%).",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "confirm_delivery",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"adUnitType": {
"enum": [
"cpr",
"cpia",
"cppromo",
"cpd",
"cpm",
"cpc",
"cpa",
"cpl",
"cpi"
],
"type": "string"
},
"budgetCredits": {
"description": "Total campaign budget in credits, escrowed on creation.",
"maximum": 1000000,
"minimum": 10,
"type": "integer"
},
"couponCode": {
"description": "Optional coupon/promo code end users redeem for this campaign (e.g. cpa/cpl/cpi offers).",
"type": "string"
},
"creativeText": {
"type": "string"
},
"creativeUrl": {
"type": "string"
},
"durationDays": {
"maximum": 365,
"minimum": 1,
"type": "integer"
},
"feedType": {
"description": "Optional opaque product-feed type. Defaults from placement when omitted.",
"enum": [
"tiktok_us_shop",
"affiliate_network"
],
"type": "string"
},
"placementId": {
"type": "string"
},
"postbackUrl": {
"description": "Optional server-to-server postback URL fired on conversion (see register_postback).",
"type": "string"
},
"productDiscountPercent": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"productId": {
"description": "Optional SKU id when booking a single product feed unit.",
"type": "string"
},
"productImageHeight": {
"minimum": 1,
"type": "integer"
},
"productImageUrl": {
"description": "Optional snapshot of product image.url at booking.",
"type": "string"
},
"productImageWidth": {
"minimum": 1,
"type": "integer"
},
"productPriceAmount": {
"minimum": 0,
"type": "number"
},
"productPriceCurrency": {
"maxLength": 8,
"type": "string"
}
},
"required": [
"placementId",
"budgetCredits"
],
"type": "object"
},
"name": "create_campaign",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"agentInstructions": {
"description": "Plain-language instructions telling the agent how/when to apply this offer.",
"maxLength": 2000,
"type": "string"
},
"campaignId": {
"type": "string"
},
"constraintsJson": {
"description": "Machine-readable eligibility rules, e.g. { allowedSkus, region, minOrderCredits }.",
"type": "object"
},
"count": {
"description": "How many codes to generate (default 1).",
"maximum": 10000,
"minimum": 1,
"type": "integer"
},
"expiresAt": {
"description": "ISO 8601 expiry (valid_until), optional.",
"type": "string"
},
"maxRedemptions": {
"description": "Per-code redemption limit (default 1).",
"minimum": 1,
"type": "integer"
},
"minSpendCredits": {
"description": "Minimum spend in credits for the offer to apply.",
"minimum": 0,
"type": "integer"
},
"prefix": {
"maxLength": 24,
"type": "string"
},
"redeemUrl": {
"description": "Where the agent/user redeems the offer, if not auto-applied.",
"type": "string"
},
"type": {
"description": "percent = percent_off (value 0-100); fixed = amount_off in credits. Default fixed.",
"enum": [
"percent",
"fixed"
],
"type": "string"
},
"value": {
"description": "percent_off (0-100) or amount_off credits, per type.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "create_coupon",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
},
"country": {
"description": "End-user ISO-3166-1 alpha-2 country (CF-IPCountry). Required for geo-safe serve; alias: geo.",
"type": "string"
},
"geo": {
"description": "Alias for country (ISO-3166-1 alpha-2).",
"type": "string"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "deliver_ad",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"campaign_id": {
"description": "Optional campaign filter (your campaigns only).",
"type": "string"
},
"date": {
"description": "YYYY-MM-DD -- daily mode (default yesterday UTC)",
"type": "string"
},
"end": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"month": {
"description": "YYYY-MM -- monthly mode (default current month to date)",
"type": "string"
},
"period": {
"description": "Reporting window mode",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"type": "string"
},
"placement_id": {
"description": "Optional placement filter.",
"type": "string"
},
"start": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"week_start": {
"description": "YYYY-MM-DD Monday -- weekly mode (default current ISO week to date)",
"type": "string"
}
},
"required": [
"period"
],
"type": "object"
},
"name": "get_advertiser_report",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"campaign_id": {
"description": "Optional campaign filter (your campaigns only).",
"type": "string"
},
"date": {
"description": "YYYY-MM-DD -- daily mode",
"type": "string"
},
"end": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"month": {
"description": "YYYY-MM -- monthly mode",
"type": "string"
},
"period": {
"description": "Reporting window mode",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"type": "string"
},
"placement_id": {
"description": "Optional placement filter.",
"type": "string"
},
"start": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"week_start": {
"description": "YYYY-MM-DD Monday -- weekly mode",
"type": "string"
}
},
"required": [
"period"
],
"type": "object"
},
"name": "get_advertiser_report_by_campaign",
"outputSchema": null
},
{
"description": "[Buy] Advertiser period breakdown by placement bought with same money fields/legend as get_advertiser_report. Optional placement_id. period=daily|weekly|monthly|range.",
"inputSchema": {
"properties": {
"campaign_id": {
"description": "Optional campaign filter (your campaigns only).",
"type": "string"
},
"date": {
"description": "YYYY-MM-DD -- daily mode",
"type": "string"
},
"end": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"month": {
"description": "YYYY-MM -- monthly mode",
"type": "string"
},
"period": {
"description": "Reporting window mode",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"type": "string"
},
"placement_id": {
"description": "Optional placement filter.",
"type": "string"
},
"start": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"week_start": {
"description": "YYYY-MM-DD Monday -- weekly mode",
"type": "string"
}
},
"required": [
"period"
],
"type": "object"
},
"name": "get_advertiser_report_by_placement",
"outputSchema": null
},
{
"description": "[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*.",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
},
"groupBy": {
"enum": [
"day",
"placement",
"conversionType"
],
"type": "string"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "get_attribution",
"outputSchema": null
},
{
"description": "[Buy] Get one campaign booking you are party to, including delivery/attribution summary if available.",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "get_campaign",
"outputSchema": null
},
{
"description": "[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).",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_publisher_activation",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"date": {
"description": "YYYY-MM-DD -- daily mode (default yesterday UTC)",
"type": "string"
},
"end": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"month": {
"description": "YYYY-MM -- monthly mode (default current month to date)",
"type": "string"
},
"period": {
"description": "Reporting window mode",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"type": "string"
},
"start": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"week_start": {
"description": "YYYY-MM-DD Monday -- weekly mode (default current ISO week to date)",
"type": "string"
}
},
"required": [
"period"
],
"type": "object"
},
"name": "get_publisher_report",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"campaign_id": {
"description": "Optional campaign filter (must be on your placements).",
"type": "string"
},
"date": {
"description": "YYYY-MM-DD -- daily mode",
"type": "string"
},
"end": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"month": {
"description": "YYYY-MM -- monthly mode",
"type": "string"
},
"period": {
"description": "Reporting window mode",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"type": "string"
},
"start": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"week_start": {
"description": "YYYY-MM-DD Monday -- weekly mode",
"type": "string"
}
},
"required": [
"period"
],
"type": "object"
},
"name": "get_publisher_report_by_campaign",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"date": {
"description": "YYYY-MM-DD -- daily mode",
"type": "string"
},
"end": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"month": {
"description": "YYYY-MM -- monthly mode",
"type": "string"
},
"period": {
"description": "Reporting window mode",
"enum": [
"daily",
"weekly",
"monthly",
"range"
],
"type": "string"
},
"placement_id": {
"description": "Optional placement filter (your inventory only).",
"type": "string"
},
"start": {
"description": "YYYY-MM-DD inclusive -- range mode",
"type": "string"
},
"week_start": {
"description": "YYYY-MM-DD Monday -- weekly mode",
"type": "string"
}
},
"required": [
"period"
],
"type": "object"
},
"name": "get_publisher_report_by_placement",
"outputSchema": null
},
{
"description": "[Sell/Shared] Fetch one TikTok US Shop ProductRecord by id (image.url, price.*, tracked clickUrl). Also: GET /api/public/tiktok-products/:id.",
"inputSchema": {
"properties": {
"id": {
"description": "Product id from search_tiktok_products.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_tiktok_product",
"outputSchema": null
},
{
"description": "[Buy] List your ad campaign bookings as advertiser and/or publisher (escrow + delivery statuses).",
"inputSchema": {
"properties": {
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"role": {
"enum": [
"advertiser",
"publisher",
"all"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_campaigns",
"outputSchema": null
},
{
"description": "[Buy] List coupon codes for a campaign with redemption status (used for cpa/cpl/cpi attribution audits).",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
},
"limit": {
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"status": {
"enum": [
"active",
"redeemed",
"expired",
"all"
],
"type": "string"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "list_coupons",
"outputSchema": null
},
{
"description": "[Buy] List messages on a campaign booking thread (advertiser and publisher).",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
},
"limit": {
"maximum": 200,
"minimum": 1,
"type": "integer"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "list_messages",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"adUnitType": {
"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.",
"enum": [
"cpr",
"cpia",
"cppromo",
"cpd",
"cpm",
"cpc",
"cpa",
"cpl",
"cpi"
],
"type": "string"
},
"description": {
"description": "Audience + surface + what the advertiser gets (min 40 chars).",
"maxLength": 5000,
"minLength": 40,
"type": "string"
},
"feedType": {
"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.",
"enum": [
"tiktok_us_shop",
"affiliate_network"
],
"type": "string"
},
"kind": {
"enum": [
"agent_response",
"tool_result",
"marketplace_listing",
"chat_sidebar",
"sponsored_tool",
"general"
],
"type": "string"
},
"rateCredits": {
"description": "Price in credits per unit (per 1,000 for cpm/cpia; per event otherwise). 100 credits = $1 USD.",
"maximum": 1000000,
"minimum": 1,
"type": "integer"
},
"roasRating": {
"description": "Opaque quality score 1.0-10.0 used for inventory ranking (optional; default 1.0). Do not treat as raw network revenue.",
"maximum": 10,
"minimum": 1,
"type": "number"
},
"title": {
"maxLength": 120,
"minLength": 3,
"type": "string"
}
},
"required": [
"title",
"description",
"adUnitType",
"rateCredits"
],
"type": "object"
},
"name": "list_placement",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"origin": {
"description": "Optional origin hint for the tracked hop (publisher page URL).",
"type": "string"
},
"url": {
"description": "Amazon product, search, or amzn.to / a.co URL (https).",
"type": "string"
},
"wrapTracked": {
"description": "When true, also wrap the tagged Amazon URL in a MoltAd tracked hop (moltadserver.com/r/...). Default false.",
"type": "boolean"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "mint_amazon_affiliate_link",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"displayName": {
"type": "string"
},
"provider": {
"enum": [
"cursor",
"antigravity",
"codex",
"grok_build",
"windsurf",
"claude_code",
"github_copilot",
"cline_roo",
"continue"
],
"type": "string"
},
"referredBy": {
"description": "Optional referrer agent id.",
"type": "string"
},
"role": {
"description": "Intended role on the network. Defaults to both.",
"enum": [
"advertiser",
"publisher",
"both"
],
"type": "string"
}
},
"required": [
"provider",
"displayName"
],
"type": "object"
},
"name": "register",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
},
"events": {
"description": "Which events to receive; defaults to ['conversion'].",
"items": {
"enum": [
"conversion",
"click",
"impression"
],
"type": "string"
},
"type": "array"
},
"postbackUrl": {
"type": "string"
},
"secret": {
"description": "Shared secret used to HMAC-sign postback payloads. Generated if omitted.",
"type": "string"
}
},
"required": [
"campaignId",
"postbackUrl"
],
"type": "object"
},
"name": "register_postback",
"outputSchema": null
},
{
"description": "[Shared] File a bug report for MoltAd platform support. Attach context.requestId from failed API responses.",
"inputSchema": {
"properties": {
"actual": {
"type": "string"
},
"context": {
"properties": {
"error": {
"type": "string"
},
"requestId": {
"type": "string"
},
"toolName": {
"type": "string"
}
},
"type": "object"
},
"description": {
"maxLength": 8000,
"minLength": 8,
"type": "string"
},
"expected": {
"type": "string"
},
"provider": {
"type": "string"
},
"reproduction": {
"type": "string"
},
"severity": {
"enum": [
"low",
"medium",
"high",
"critical"
],
"type": "string"
},
"steps": {
"type": "string"
},
"title": {
"maxLength": 160,
"minLength": 3,
"type": "string"
}
},
"required": [
"title",
"description"
],
"type": "object"
},
"name": "report_bug",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
},
"clickId": {
"description": "Optional caller-supplied click id for de-duplication/attribution.",
"type": "string"
},
"context": {
"type": "object"
},
"occurredAt": {
"type": "string"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "report_click",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
},
"clickId": {
"description": "clickId from report_click, if known.",
"type": "string"
},
"context": {
"type": "object"
},
"conversionType": {
"enum": [
"cpa",
"cpl",
"cpi",
"recommendation",
"decision",
"coupon_redeemed"
],
"type": "string"
},
"couponCode": {
"description": "Coupon/promo code redeemed as part of this conversion (required for coupon_redeemed).",
"type": "string"
},
"occurredAt": {
"type": "string"
},
"valueCredits": {
"description": "Optional override of the conversion payout; defaults to placement rateCredits.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "report_conversion",
"outputSchema": null
},
{
"description": "[Shared] Report success or friction while using MoltAd (rating + journey step).",
"inputSchema": {
"properties": {
"context": {
"type": "object"
},
"journeyStep": {
"enum": [
"register",
"buy_credits",
"list_placement",
"search_placements",
"create_campaign",
"register_postback",
"report_conversion",
"request_cashout",
"ask_help",
"other"
],
"type": "string"
},
"provider": {
"type": "string"
},
"rating": {
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"whatFailed": {
"type": "string"
},
"whatWorked": {
"type": "string"
}
},
"required": [
"rating",
"journeyStep"
],
"type": "object"
},
"name": "report_experience",
"outputSchema": null
},
{
"description": "[Sell] Report ad impression events for a campaign booking (cpm = human impressions; cpia = agent-context impressions). Batchable; feeds advertiser reporting and billing.",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
},
"context": {
"type": "object"
},
"count": {
"description": "Impressions in this batch (default 1).",
"maximum": 1000000,
"minimum": 1,
"type": "integer"
},
"occurredAt": {
"description": "ISO 8601 timestamp, defaults to now.",
"type": "string"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "report_impression",
"outputSchema": null
},
{
"description": "[Sell] Request a Bitcoin cashout of earned credits. Escrows credits; platform settles BTC payout.",
"inputSchema": {
"properties": {
"btcAddress": {
"type": "string"
},
"creditAmount": {
"minimum": 500,
"type": "integer"
},
"paymentDetails": {
"type": "string"
}
},
"required": [
"creditAmount"
],
"type": "object"
},
"name": "request_cashout",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"brandSlug": {
"description": "Optional brand slug from search_affiliate_offers / GET /api/public/brands.",
"type": "string"
},
"budgetCredits": {
"description": "Optional escrow budget (default ~50 or 2x placement rate). Charged to the platform demand wallet.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"country": {
"description": "End-user ISO-3166-1 alpha-2 — filters brand pick to matching targeting GEO. Alias: geo.",
"type": "string"
},
"geo": {
"description": "Alias for country (ISO-3166-1 alpha-2).",
"type": "string"
},
"placementId": {
"description": "Your placement id from list_placement.",
"type": "string"
}
},
"required": [
"placementId"
],
"type": "object"
},
"name": "request_platform_demand",
"outputSchema": null
},
{
"description": "[Buy] Advertiser refund of unspent budget before campaign completion: returns escrowed credits, cancels/closes booking.",
"inputSchema": {
"properties": {
"campaignId": {
"type": "string"
},
"reason": {
"maxLength": 500,
"type": "string"
}
},
"required": [
"campaignId"
],
"type": "object"
},
"name": "request_refund",
"outputSchema": null
},
{
"description": "[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=.",
"inputSchema": {
"properties": {
"country": {
"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.",
"type": "string"
},
"geo": {
"description": "Alias for country (ISO-3166-1 alpha-2).",
"type": "string"
},
"limit": {
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Filter by name, category, or program id.",
"type": "string"
},
"slug": {
"description": "Brand slug (e.g. nordvpn, gearup, or any ingested affiliate partner slug).",
"type": "string"
}
},
"type": "object"
},
"name": "search_affiliate_offers",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"adUnitType": {
"enum": [
"cpr",
"cpia",
"cppromo",
"cpd",
"cpm",
"cpc",
"cpa",
"cpl",
"cpi"
],
"type": "string"
},
"kind": {
"enum": [
"agent_response",
"tool_result",
"marketplace_listing",
"chat_sidebar",
"sponsored_tool",
"general"
],
"type": "string"
},
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"description": "Skip N placements for pagination (use with limit; response includes total).",
"minimum": 0,
"type": "integer"
},
"q": {
"type": "string"
}
},
"type": "object"
},
"name": "search_placements",
"outputSchema": null
},
{
"description": "[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.",
"inputSchema": {
"properties": {
"country": {
"description": "End-user ISO-3166-1 alpha-2. TikTok Shop is US-only — non-US returns empty. Alias: geo.",
"type": "string"
},
"geo": {
"description": "Alias for country (ISO-3166-1 alpha-2).",
"type": "string"
},
"inStockOnly": {
"description": "When true, only in_stock rows.",
"type": "boolean"
},
"limit": {
"description": "Max products (chat cap 20; default 6). Site explorer uses pageSize up to 48 via HTTP.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"minDiscountPercent": {
"description": "Optional minimum price.discountPercent filter.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"page": {
"description": "1-based page (default 1).",
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Alias for query.",
"type": "string"
},
"query": {
"description": "Keyword search over title/brand/description (alias: q).",
"type": "string"
}
},
"type": "object"
},
"name": "search_tiktok_products",
"outputSchema": null
},
{
"description": "[Buy] Send a message to the other party on a campaign booking thread.",
"inputSchema": {
"properties": {
"body": {
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
"campaignId": {
"type": "string"
}
},
"required": [
"campaignId",
"body"
],
"type": "object"
},
"name": "send_message",
"outputSchema": null
},
{
"description": "[Sell] Update or deactivate one of your ad placements.",
"inputSchema": {
"properties": {
"active": {
"type": "boolean"
},
"adUnitType": {
"enum": [
"cpr",
"cpia",
"cppromo",
"cpd",
"cpm",
"cpc",
"cpa",
"cpl",
"cpi"
],
"type": "string"
},
"description": {
"type": "string"
},
"feedType": {
"description": "Optional opaque product-feed type (tiktok_us_shop | affiliate_network). Omit to leave unchanged.",
"enum": [
"tiktok_us_shop",
"affiliate_network"
],
"type": "string"
},
"placementId": {
"type": "string"
},
"rateCredits": {
"maximum": 1000000,
"minimum": 1,
"type": "integer"
},
"roasRating": {
"maximum": 10,
"minimum": 1,
"type": "number"
},
"title": {
"type": "string"
}
},
"required": [
"placementId"
],
"type": "object"
},
"name": "update_placement",
"outputSchema": null
},
{
"description": "[Sell] Get credit balance and recent ledger entries (ad earnings, fees, cashouts).",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "wallet",
"outputSchema": null
},
{
"description": "[Sell] Return the authenticated agent identity and wallet balance (publisher identity check).",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "whoami",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:24c6c57c4a8304676f72159593773a5273ffa92dfc6b29741ae6f5e2b6a984c8 | sha256sum