pubweb-ads-mcp 0.1.0 → 0.2.0

package/README.md

@@ -53,6 +53,9 @@ PUBWEB_API_KEY=... npm run smoke               # lists the tools (sanity check)
 | `ad_media(id)` | Presigned image/video URLs (30-min TTL) |
 | `ad_funnel(id)` | The ad's landing→destination funnel |
 | `targets_list()` | Competitor domains you track, with ad counts |
+| `adx_kpis(site?, from?, to?)` | AdX ad-serving funnel KPIs for **your** sites (requests/fills/viewability/ctr) — needs `v1:adx:read` |
+| `adx_timeseries(site?, from?, to?, granularity?)` | AdX funnel over time (hour/day/week) |
+| `adx_fill_report(site?, from?, to?)` | AdX funnel by block / country / price bucket / size / device |
 | `whoami()` | Verify the key + see its abilities (setup/debug) |
 
 ## Security

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pubweb-ads-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server exposing the pubweb Ads knowledge base (semantic search over scraped competitor ads, with media + funnels) to Claude and other MCP clients.",
   "type": "module",
   "license": "MIT",

package/src/index.js

@@ -13,7 +13,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 
-const VERSION = '0.1.0';
+const VERSION = '0.2.0';
 const API_URL = (process.env.PUBWEB_API_URL || 'https://app.pubweb.ai').replace(/\/+$/, '');
 const API_KEY = process.env.PUBWEB_API_KEY;
 
@@ -131,6 +131,42 @@ server.tool(
   async () => run(() => apiGet('/me')),
 );
 
+// ── AdX ad-serving telemetry (your own sites — needs ability v1:adx:read) ──
+
+server.tool(
+  'adx_kpis',
+  'AdX ad-serving funnel KPIs over a window for YOUR sites: requests, fills, unfills, viewables, clicks, refreshes + derived fill_rate, viewability, ctr. No revenue/cost — funnel health only.',
+  {
+    site: z.string().optional().describe('One of your site ids (default: all your sites)'),
+    from: z.string().optional().describe('ISO date — start (default: 7 days ago)'),
+    to: z.string().optional().describe('ISO date — end (default: now)'),
+  },
+  async (args) => run(() => apiGet('/adx/kpis', args)),
+);
+
+server.tool(
+  'adx_timeseries',
+  'AdX funnel per time bucket (hour | day | week) for your sites — the same counters as adx_kpis over time.',
+  {
+    site: z.string().optional(),
+    from: z.string().optional(),
+    to: z.string().optional(),
+    granularity: z.enum(['hour', 'day', 'week']).optional().describe('Bucket size (default: day)'),
+  },
+  async (args) => run(() => apiGet('/adx/timeseries', args)),
+);
+
+server.tool(
+  'adx_fill_report',
+  'AdX funnel broken down by block (code), country (cc), price_rule (floor ladder bucket), brand-safety, size and device.',
+  {
+    site: z.string().optional(),
+    from: z.string().optional(),
+    to: z.string().optional(),
+  },
+  async (args) => run(() => apiGet('/adx/fill-report', args)),
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);
 console.error(`[pubweb-ads-mcp] ready → ${API_URL}/api/v1`);