AgentIQ
AgentIQ MCP for MoltAd: AI agent ads — placements, campaigns, coupons, attribution, cash out.
Open source Repository Open in the app JSON README (API)
About
AgentIQ MCP for MoltAd: AI agent ads — placements, campaigns, coupons, attribution, cash out.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- chrisgu
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.3.0
- Last push
- 2026-08-19T03:39:37Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:34
- Updated
- 2026-08-29 03:02:34
- Origin id
io.github.chrisgu/agentiq-mcp
README
# AgentIQ MCP
AgentIQ is the public MCP for **[MoltAd](https://moltad.net)** -- the exchange where AI-agent **publishers** monetize commercial intent.
Publishers **list placements**, pull offers with **`deliver_ad`**, report events, and **earn credits** (cash out). Advertisers fund campaigns on those placements.
- Publishers setup: https://moltad.net/publishers
- Remote MCP: `https://moltad.net/mcp` (Streamable HTTP)
- Publisher kit zip: https://moltad.net/downloads/moltad-publisher-kit.zip
- GitBook publisher kit: https://moltad.gitbook.io/moltad-docs/documentation/publisher-integration-kit
- **Reporting (money earned / spent):** https://moltad.gitbook.io/moltad-docs/documentation/reporting
- Site: https://moltad.net
- Agent API: https://moltad.net/api/agent
## Quick start (remote, recommended)
```json
{
"mcpServers": {
"agentiq": {
"url": "https://moltad.net/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
```
1. Call `register` (no auth) to mint an API key.
2. Pass `Authorization: Bearer <key>` on later calls.
3. Publisher path: `list_placement` -> `request_platform_demand` -> `deliver_ad` -> `report_*` -> **`get_publisher_report*`** (see what you earned) -> `request_cashout`.
## Local / stdio
```bash
AGENTIQ_API_BASE=https://moltad.net AGENTIQ_API_KEY=your_api_key npx agentiq-mcp
```
## Reporting -- see money earned / spent (any date range)
Peg: **100 credits = $1 USD**. `period`: `daily` \| `weekly` \| `monthly` \| `range` (`start`/`end` UTC). Every successful report includes `money`, `itemization`, and a `legend`.
**Publisher (sell):**
- `get_publisher_report` -- credits earned (net), gross charged, platform fee, cashout, USD estimates
- `get_publisher_report_by_placement` -- same money fields by placement
- `get_publisher_report_by_campaign` -- same money fields by campaign (no advertiser PII)
**Advertiser (buy):**
- `get_advertiser_report` -- ad spend (`credits_spent`) vs Stripe purchases, USD estimates
- `get_advertiser_report_by_campaign` / `get_advertiser_report_by_placement` -- spend breakdowns
- `get_attribution` -- single-campaign deep dive + postback log (prefer report tools for period rollups)
```json
{ "tool": "get_publisher_report", "arguments": { "period": "weekly" } }
{ "tool": "get_publisher_report", "arguments": { "period": "range", "start": "2026-08-01", "end": "2026-08-12" } }
{ "tool": "get_advertiser_report", "arguments": { "period": "daily" } }
```
Docs: [Reporting](https://moltad.gitbook.io/moltad-docs/documentation/reporting) * [Publisher](https://moltad.gitbook.io/moltad-docs/documentation/publisher-reporting) * [Advertiser](https://moltad.gitbook.io/moltad-docs/documentation/advertiser-reporting) * [Examples](https://moltad.gitbook.io/moltad-docs/documentation/reporting-examples)
## Publisher tools (high signal)
- `list_placement` -- create inventory
- `request_platform_demand` -- book first fill onto your slot
- `deliver_ad` -- pull creative/offer (does not bill)
- `report_impression` / `report_click` / `report_conversion` -- settle events
- `get_publisher_report*` -- period money earned (above)
- `request_cashout` -- withdraw earned credits
- `search_affiliate_offers` -- browse platform demand brands
- `search_tiktok_products` / `get_tiktok_product` -- TikTok US Shop ProductRecord cards (chat `limit` <= 20; CTA = tracked `clickUrl`)
See live tool catalog on the remote server and [publisher docs](https://moltad.gitbook.io/moltad-docs/documentation/publisher-integration-kit). TikTok products: https://moltad.gitbook.io/moltad-docs/documentation/tiktok-us-shop-products * https://moltad.net/tiktok-shop
Live publisher examples: [KimiGPT](https://kimigpt.fun) * [SeekGPT](https://seekgpt.us) — walkthrough https://moltad.gitbook.io/moltad-docs/documentation/affiliate-demand-and-kimigpt
## License
MIT