@cesteral/ttd-mcp 1.0.0

package/dist/mcp-server/prompts/definitions/report-generation-workflow.prompt.js

@@ -0,0 +1,163 @@
+export const reportGenerationWorkflowPrompt = {
+    name: "ttd_report_generation_workflow",
+    description: "Step-by-step workflow for generating async reports via TTD MyReports API, including dimension/metric selection and common report patterns",
+    arguments: [
+        {
+            name: "advertiserId",
+            description: "TTD Advertiser ID to scope the report to",
+            required: true,
+        },
+    ],
+};
+export function getReportGenerationWorkflowMessage(args) {
+    const advertiserId = args?.advertiserId || "{advertiserId}";
+    return `# TTD Report Generation Workflow
+
+## Context
+- Advertiser ID: \`${advertiserId}\`
+- API: TTD MyReports (async report generation)
+
+Reports in TTD are asynchronous: you submit a report configuration, TTD processes it, and results are retrieved when ready. The \`ttd_get_report\` tool handles this flow end-to-end.
+
+---
+
+## Step 1: Choose Your Report Goal
+
+Before building a report, decide what question you're answering:
+
+| Goal | Recommended Dimensions | Recommended Metrics |
+|------|----------------------|---------------------|
+| Campaign overview | \`CampaignId\`, \`CampaignName\` | \`Impressions\`, \`Clicks\`, \`CTR\`, \`TotalCost\` |
+| Daily delivery trend | \`Date\`, \`CampaignName\` | \`Impressions\`, \`TotalCost\` |
+| Device breakdown | \`DeviceType\` | \`Impressions\`, \`Clicks\`, \`CTR\`, \`eCPM\` |
+| Geo performance | \`Country\`, \`Region\` | \`Impressions\`, \`TotalCost\`, \`CTR\` |
+| Video completion | \`CampaignName\`, \`AdGroupName\` | \`VideoStarted\`, \`VideoCompleted\`, \`VCR\` |
+| Conversion analysis | \`CampaignName\` | \`TotalConversions\`, \`eCPA\`, \`ConversionRate\` |
+
+> Fetch \`report-reference://all\` for the complete list of dimensions and metrics.
+
+---
+
+## Step 2: Select Date Range
+
+| Value | Use When |
+|-------|----------|
+| \`Yesterday\` | Quick daily check |
+| \`Last7Days\` | Weekly review |
+| \`Last30Days\` | Monthly analysis |
+| \`MonthToDate\` | Current month progress |
+| \`Custom\` | Specific date range (add \`ReportStartDate\`/\`ReportEndDate\` to \`additionalConfig\`) |
+
+---
+
+## Step 3: Run the Report
+
+\`\`\`
+Tool: ttd_get_report
+Input: {
+  "reportName": "Campaign Performance - ${advertiserId}",
+  "dateRange": "Last7Days",
+  "dimensions": ["CampaignId", "CampaignName"],
+  "metrics": ["Impressions", "Clicks", "CTR", "TotalCost", "eCPM"],
+  "advertiserIds": ["${advertiserId}"]
+}
+\`\`\`
+
+### Custom Date Range Example
+
+\`\`\`
+Tool: ttd_get_report
+Input: {
+  "reportName": "March Performance",
+  "dateRange": "Custom",
+  "dimensions": ["Date", "CampaignName"],
+  "metrics": ["Impressions", "TotalCost"],
+  "advertiserIds": ["${advertiserId}"],
+  "additionalConfig": {
+    "ReportStartDate": "2025-03-01T00:00:00",
+    "ReportEndDate": "2025-03-31T23:59:59"
+  }
+}
+\`\`\`
+
+---
+
+## Step 4: Download & Parse Results
+
+\`ttd_get_report\` returns a \`downloadUrl\` pointing to a CSV file. Use \`ttd_download_report\` to fetch a bounded summary first:
+
+\`\`\`
+Tool: ttd_download_report
+Input: {
+  "downloadUrl": "{downloadUrl from Step 3}"
+}
+\`\`\`
+
+The tool returns:
+- \`headers\` — Column names from the CSV
+- \`previewRows\` — Small parsed preview in summary mode
+- \`rows\` — Parsed row page when \`mode: "rows"\`
+- \`totalRows\` / \`returnedRows\` — Row counts
+- \`truncated\` / \`nextOffset\` — Whether more rows are available
+- \`selectedColumns\` — Columns included in row payloads
+
+### Handling Large Reports
+
+\`\`\`
+Tool: ttd_download_report
+Input: {
+  "downloadUrl": "{downloadUrl from Step 3}",
+  "mode": "rows",
+  "columns": ["Site", "Impressions", "TotalCost"],
+  "maxRows": 50,
+  "offset": 0
+}
+\`\`\`
+
+Use \`columns\` to project only the fields needed for the analysis. Use \`nextOffset\` for the next page. \`maxRows\` is capped at 200 to avoid MCP response-size failures.
+
+⚠️ **GOTCHA**: If \`ttd_get_report\` returns no \`downloadUrl\`, the report may still be processing. Wait and retry the \`ttd_get_report\` call.
+
+---
+
+## Common Report Patterns
+
+### Pacing Check
+Compares daily spend to expected daily spend:
+\`\`\`json
+{
+  "reportName": "Pacing Check",
+  "dateRange": "Last7Days",
+  "dimensions": ["Date", "CampaignId", "CampaignName"],
+  "metrics": ["TotalCost", "Impressions"],
+  "advertiserIds": ["${advertiserId}"]
+}
+\`\`\`
+Compare daily \`TotalCost\` against \`Budget.Amount / flight_days\` from the campaign entity.
+
+### Creative Performance
+\`\`\`json
+{
+  "reportName": "Creative Performance",
+  "dateRange": "Last14Days",
+  "dimensions": ["CreativeId", "AdName", "CampaignName"],
+  "metrics": ["Impressions", "Clicks", "CTR", "eCPM"],
+  "advertiserIds": ["${advertiserId}"]
+}
+\`\`\`
+
+---
+
+## Tips
+
+- Keep dimensions minimal — each additional dimension multiplies row count
+- Always include \`advertiserIds\` filter to scope the report
+- For large reports, use shorter date ranges
+- Combine with entity tools: fetch campaign budget via \`ttd_get_entity\`, then run a report to check pacing
+
+## Related Resources
+- \`report-reference://all\` — Full list of dimensions, metrics, and date ranges
+- \`entity-schema://campaign\` — Campaign fields for budget/pacing context
+`;
+}
+//# sourceMappingURL=report-generation-workflow.prompt.js.map

package/dist/mcp-server/prompts/definitions/report-generation-workflow.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-generation-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/report-generation-workflow.prompt.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,8BAA8B,GAAW;IACpD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,2IAA2I;IAC7I,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,0CAA0C;YACvD,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,kCAAkC,CAAC,IAA6B;IAC9E,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAE5D,OAAO;;;qBAGY,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0CAyCS,YAAY;;;;uBAI/B,YAAY;;;;;;;;;;;;;uBAaZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA0DZ,YAAY;;;;;;;;;;;;uBAYZ,YAAY;;;;;;;;;;;;;;;;CAgBlC,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const ttdTargetingDiscoveryWorkflowPrompt: Prompt;
+export declare function getTtdTargetingDiscoveryWorkflowMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=targeting-discovery-workflow.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targeting-discovery-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,mCAAmC,EAAE,MAiBjD,CAAC;AAEF,wBAAgB,uCAAuC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAkP7F"}

package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js

@@ -0,0 +1,259 @@
+export const ttdTargetingDiscoveryWorkflowPrompt = {
+    name: "ttd_targeting_discovery_workflow",
+    description: "Step-by-step guide for researching and configuring TTD ad group targeting — covers site lists, bid lists, geo segments, audience targeting, and private marketplace deals.",
+    arguments: [
+        {
+            name: "advertiserId",
+            description: "TTD Advertiser ID",
+            required: true,
+        },
+        {
+            name: "goal",
+            description: "Targeting goal: 'site' (inventory targeting), 'audience' (segment targeting), 'geo' (geographic targeting), or 'deal' (PMP deals). Default: audience",
+            required: false,
+        },
+    ],
+};
+export function getTtdTargetingDiscoveryWorkflowMessage(args) {
+    const advertiserId = args?.advertiserId || "{advertiserId}";
+    const goal = args?.goal || "audience";
+    return `# TTD Targeting Discovery Workflow
+
+Advertiser ID: \`${advertiserId}\`
+Goal: \`${goal}\`
+
+---
+
+## Overview
+
+TTD targeting is configured at the **ad group level** via \`RTBAttributes\`. Key targeting mechanisms:
+
+| Targeting Type | Mechanism | Set Via |
+|---------------|-----------|---------|
+| **Inventory** | Site lists (allowlists/blocklists) | \`SiteListId\` in ad group |
+| **Audience** | Third-party segments, data providers | \`AudienceId\` in ad group |
+| **Geography** | Country/region/city codes | \`GeoSegments\` in ad group |
+| **Deals** | PMP/private deals | \`DealId\` in ad group |
+| **Bid Modifiers** | Dimension-level adjustments | Bid lists attached to ad group |
+
+> Fetch \`entity-schema://adGroup\` for the full \`RTBAttributes\` targeting field reference.
+
+---
+
+## Step 1: Inventory Targeting — Site Lists
+
+### Browse Existing Site Lists
+
+\`\`\`
+Tool: ttd_list_entities
+Input: {
+  "entityType": "siteList",
+  "advertiserId": "${advertiserId}"
+}
+\`\`\`
+
+### Create a New Site List (Allowlist)
+
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "siteList",
+  "data": {
+    "SiteListName": "Premium News Publishers",
+    "AdvertiserId": "${advertiserId}",
+    "SiteListType": "Whitelist",
+    "Sites": ["nytimes.com", "bbc.com", "reuters.com", "theguardian.com"]
+  }
+}
+\`\`\`
+
+**Save**: Note the returned \`SiteListId\` — you'll reference it in the ad group.
+
+### Site List Types
+
+| Type | Effect |
+|------|--------|
+| \`Whitelist\` | Only bid on these sites |
+| \`Blacklist\` | Exclude these sites, bid on all others |
+
+### Attach Site List to Ad Group
+
+Include in \`RTBAttributes\` when creating/updating an ad group:
+
+\`\`\`
+"RTBAttributes": {
+  "SiteLists": [{ "SiteListId": "{SiteListId}", "SiteListType": "Whitelist" }],
+  "BaseBidCPM": { "Amount": 5.00, "CurrencyCode": "USD" }
+}
+\`\`\`
+
+---
+
+## Step 2: Geographic Targeting
+
+TTD uses ISO country codes and region identifiers for geo targeting.
+
+### Common Geo Codes
+
+| Code | Region |
+|------|--------|
+| \`USA\` | United States |
+| \`GBR\` | United Kingdom |
+| \`DEU\` | Germany |
+| \`FRA\` | France |
+| \`AUS\` | Australia |
+| \`US-CA\` | California, US |
+| \`US-NY\` | New York, US |
+
+### Apply Geo Targeting in Ad Group
+
+\`\`\`
+"RTBAttributes": {
+  "GeoSegments": ["USA", "GBR"],
+  "BaseBidCPM": { "Amount": 5.00, "CurrencyCode": "USD" }
+}
+\`\`\`
+
+### Geo Bid Adjustments via Bid Lists
+
+To bid differently by region (not just include/exclude):
+
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "bidList",
+  "data": {
+    "BidListName": "US Regional Bid Modifiers",
+    "AdvertiserId": "${advertiserId}",
+    "BidListDimension": "GeoRegion",
+    "BidListAdjustmentType": "PercentageAdjustment",
+    "BidListEntries": [
+      { "DimensionValue": "US-CA", "AdjustmentValue": 50, "IsEnabled": true },
+      { "DimensionValue": "US-NY", "AdjustmentValue": 30, "IsEnabled": true },
+      { "DimensionValue": "US-TX", "AdjustmentValue": -20, "IsEnabled": true }
+    ]
+  }
+}
+\`\`\`
+
+---
+
+## Step 3: Audience Targeting
+
+### Browse Available Deals (PMP)
+
+\`\`\`
+Tool: ttd_list_entities
+Input: {
+  "entityType": "deal",
+  "advertiserId": "${advertiserId}"
+}
+\`\`\`
+
+### Bid Lists for Audience Signals
+
+Bid lists support several targeting dimensions:
+
+| Dimension | Use Case |
+|-----------|----------|
+| \`GeoRegion\` | Region-level bid adjustments |
+| \`DeviceType\` | Mobile, desktop, CTV |
+| \`Browser\` | Chrome, Safari, Firefox |
+| \`OS\` | iOS, Android, Windows |
+| \`DealId\` | Per-deal bid modifiers |
+| \`SiteId\` | Per-site bid modifiers |
+
+### Browse Bid Lists
+
+\`\`\`
+Tool: ttd_list_entities
+Input: {
+  "entityType": "bidList",
+  "advertiserId": "${advertiserId}"
+}
+\`\`\`
+
+---
+
+## Step 4: Private Marketplace (PMP) Deals
+
+### Create a Deal
+
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "deal",
+  "data": {
+    "DealName": "Premium Video PMP",
+    "AdvertiserId": "${advertiserId}",
+    "DealId": "publisher-deal-id-123",
+    "SupplyVendor": "Xandr",
+    "CPMInUSD": 12.00
+  }
+}
+\`\`\`
+
+### Attach Deal to Ad Group
+
+\`\`\`
+"RTBAttributes": {
+  "Deals": [{ "DealId": "{DealId}" }],
+  "BaseBidCPM": { "Amount": 12.00, "CurrencyCode": "USD" }
+}
+\`\`\`
+
+---
+
+## Step 5: GraphQL Targeting Discovery
+
+TTD's GraphQL API offers richer targeting discovery capabilities:
+
+\`\`\`
+Tool: ttd_graphql_query
+Input: {
+  "query": "{ availableSegments(advertiserId: \\"${advertiserId}\\") { segmentId name description estimatedReach } }",
+  "variables": {}
+}
+\`\`\`
+
+---
+
+## Step 6: Assemble the Ad Group Targeting
+
+Combine your targeting inputs into the ad group \`RTBAttributes\`:
+
+\`\`\`
+Tool: ttd_create_entity
+Input: {
+  "entityType": "adGroup",
+  "data": {
+    "AdGroupName": "Brand - US Tech Decision Makers",
+    "CampaignId": "{CampaignId}",
+    "AdvertiserId": "${advertiserId}",
+    "RTBAttributes": {
+      "BudgetSettings": {
+        "DailyBudget": { "Amount": 500, "CurrencyCode": "USD" },
+        "PacingMode": "PaceAhead"
+      },
+      "BaseBidCPM": { "Amount": 5.00, "CurrencyCode": "USD" },
+      "MaxBidCPM": { "Amount": 12.00, "CurrencyCode": "USD" },
+      "GeoSegments": ["USA"],
+      "SiteLists": [{ "SiteListId": "{SiteListId}", "SiteListType": "Whitelist" }],
+      "BidLists": [{ "BidListId": "{BidListId}" }]
+    }
+  }
+}
+\`\`\`
+
+---
+
+## Related Resources
+
+- \`entity-schema://adGroup\` — Full RTBAttributes targeting field reference
+- \`entity-schema://siteList\` — Site list fields and site format
+- \`entity-schema://bidList\` — Bid list dimension options and entry format
+- \`entity-schema://deal\` — Deal fields and supply vendor codes
+- \`entity-examples://adGroup\` — Example ad groups with common targeting patterns
+`;
+}
+//# sourceMappingURL=targeting-discovery-workflow.prompt.js.map

package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targeting-discovery-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,mCAAmC,GAAW;IACzD,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,4KAA4K;IAC9K,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,mBAAmB;YAChC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,sJAAsJ;YACxJ,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,uCAAuC,CAAC,IAA6B;IACnF,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,UAAU,CAAC;IAEtC,OAAO;;mBAEU,YAAY;UACrB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA4BO,YAAY;;;;;;;;;;;;uBAYV,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAgEZ,YAAY;;;;;;;;;;;;;;;;;;;;;;qBAsBd,YAAY;;;;;;;;;;;;;;;;;;;;;;;qBAuBZ,YAAY;;;;;;;;;;;;;;;;uBAgBV,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;mDA0BgB,YAAY;;;;;;;;;;;;;;;;;;uBAkBxC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;CAyBlC,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const toolSchemaExplorationPrompt: Prompt;
+export declare function getToolSchemaExplorationMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=tool-schema-exploration.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-exploration.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/tool-schema-exploration.prompt.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,2BAA2B,EAAE,MAWzC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAqLrF"}

package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js

@@ -0,0 +1,193 @@
+export const toolSchemaExplorationPrompt = {
+    name: "ttd_tool_schema_exploration",
+    description: "Step-by-step workflow for exploring available TTD MCP tools, prompts, and resources with minimal context usage",
+    arguments: [
+        {
+            name: "objective",
+            description: "Exploration objective (e.g., entity management, reporting, troubleshooting)",
+            required: false,
+        },
+    ],
+};
+export function getToolSchemaExplorationMessage(args) {
+    const objective = args?.objective || "general capability discovery";
+    return `# TTD Tool and Schema Exploration
+
+## Context
+- Server: ttd-mcp (The Trade Desk)
+- Objective: ${objective}
+
+Use this workflow to discover TTD MCP capabilities while minimizing token usage.
+
+---
+
+## Step 1: List Capabilities
+
+Run these three calls to see what's available:
+1. \`tools/list\` — See all available tools
+2. \`prompts/list\` — See workflow prompts
+3. \`resources/list\` — See on-demand documentation resources
+
+Do **not** fetch large resources before narrowing your scope.
+
+---
+
+## Step 2: Identify Your Task Path
+
+Pick one immediate action:
+
+| Task | Start Here |
+|------|-----------|
+| Create a campaign structure | Prompt: \`ttd_campaign_setup_workflow\` |
+| Generate a report | Prompt: \`ttd_report_generation_workflow\` |
+| Debug an entity issue | Prompt: \`ttd_troubleshoot_entity\` |
+| Understand entity fields | Resource: \`entity-schema://{entityType}\` |
+| See CRUD examples | Resource: \`entity-examples://{entityType}\` |
+| Learn entity relationships | Resource: \`entity-hierarchy://all\` |
+| Find report dimensions/metrics | Resource: \`report-reference://all\` |
+
+---
+
+## Step 3: Fetch Targeted Resources
+
+Prefer specific resources over aggregate ones:
+
+| Need | Fetch |
+|------|-------|
+| Campaign fields | \`entity-schema://campaign\` (not \`://all\`) |
+| Ad group examples | \`entity-examples://adGroup\` (not \`://all\`) |
+| Report metrics | \`report-reference://all\` (only one resource) |
+
+Only use \`://all\` resources when you need a cross-entity view.
+
+---
+
+## Step 4: Execute a Minimal Tool Call
+
+Start with the simplest useful call:
+
+| Action | Tool | Minimal Input |
+|--------|------|---------------|
+| Check an entity | \`ttd_get_entity\` | \`entityType\` + \`entityId\` |
+| List entities | \`ttd_list_entities\` | \`entityType\` + \`filters\` |
+| Quick report | \`ttd_get_report\` | \`reportName\` + \`dateRange\` + \`advertiserIds\` |
+
+Inspect the output, then iterate with more specific calls.
+
+---
+
+## Available Tools Summary (43 tools)
+
+This server surfaces TTD's documented Platform API (REST + GraphQL) per TTD Foundations §1, §6. For single-record writes use \`ttd_create_entity\` / \`ttd_update_entity\` (REST). For >100-record batch writes use \`ttd_graphql_mutation_bulk\` (GraphQL bulk — TTD's documented bulk path).
+
+### Context
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_get_context\` | Get partner IDs accessible with current credentials (cold-start) | Read |
+
+### Core CRUD
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_list_entities\` | List entities with filters | Read |
+| \`ttd_get_entity\` | Get a single entity | Read |
+| \`ttd_create_entity\` | Create an entity | Write |
+| \`ttd_update_entity\` | Update an entity (PUT) | Write |
+| \`ttd_delete_entity\` | Delete an entity | Write |
+| \`ttd_validate_entity\` | Dry-run entity validation | Read/Write |
+
+### Reporting
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_get_report\` | Generate and retrieve reports (blocking) | Read |
+| \`ttd_download_report\` | Download report CSV and return bounded views | Read |
+| \`ttd_submit_report\` | Submit report without waiting (non-blocking) | Write |
+| \`ttd_check_report_status\` | Check status of submitted report | Read |
+
+### Bulk Operations
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_bulk_create_entities\` | Batch create (campaigns/ad groups) | Write |
+| \`ttd_bulk_update_entities\` | Batch update (campaigns/ad groups) | Write |
+| \`ttd_bulk_update_status\` | Batch pause/resume/archive | Write |
+| \`ttd_archive_entities\` | Batch archive (soft-delete) | Write |
+| \`ttd_adjust_bids\` | Batch bid adjustments | Write |
+
+### Advanced
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_graphql_query\` | GraphQL query/mutation passthrough | Read/Write |
+
+### GraphQL Bulk Operations
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_graphql_query_bulk\` | Execute bulk GraphQL queries | Read |
+| \`ttd_graphql_mutation_bulk\` | Execute bulk GraphQL mutations | Write |
+| \`ttd_graphql_bulk_job\` | Check async bulk GraphQL job status | Read |
+| \`ttd_graphql_cancel_bulk_job\` | Cancel running bulk job | Write |
+
+### Ad Previews (1 tool)
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_get_ad_preview\` | Get preview URL for a creative | Read |
+
+### Report Schedule Management
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_create_report_template\` | Create a MyReports template via GraphQL | Write |
+| \`ttd_update_report_template\` | Replace an existing MyReports template via GraphQL | Write |
+| \`ttd_get_report_template\` | Retrieve full MyReports template structure | Read |
+| \`ttd_create_template_schedule\` | Schedule a MyReports template via GraphQL | Write |
+| \`ttd_create_report_schedule\` | Create a recurring or one-time report schedule (legacy REST wrapper) | Write |
+| \`ttd_update_report_schedule\` | Enable or disable a report schedule via GraphQL | Write |
+| \`ttd_list_report_schedules\` | List existing report schedules | Read |
+| \`ttd_get_report_schedule\` | Get a specific report schedule | Read |
+| \`ttd_delete_report_schedule\` | Delete a report schedule | Write |
+| \`ttd_cancel_report_execution\` | Cancel an in-progress report execution via GraphQL | Write |
+| \`ttd_rerun_report_schedule\` | Trigger a fresh execution from an existing schedule | Write |
+| \`ttd_get_report_executions\` | Retrieve execution history and download links | Read |
+| \`ttd_list_report_templates\` | List MyReports template headers | Read |
+
+### GQL Entity Reports
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_execute_entity_report\` | Execute immediate entity-level report via GraphQL | Write |
+| \`ttd_get_entity_report_types\` | Discover available report types for an entity | Read |
+| \`ttd_list_report_types\` | List all catalog report types | Read |
+| \`ttd_get_report_type_schema\` | Get columns/dimensions for a report type | Read |
+
+### Bid Lists & Seeds
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_manage_bid_list\` | Create/get/update a single bid list | Read/Write |
+| \`ttd_bulk_manage_bid_lists\` | Batch get/update bid lists (up to 50) | Read/Write |
+| \`ttd_manage_seed\` | Manage audience seeds via GraphQL | Read/Write |
+
+### Discovery (1 tool)
+| Tool | Purpose | Read/Write |
+|------|---------|-----------|
+| \`ttd_search_tools\` | Rank server tools by a natural-language query | Read |
+
+### Supported REST Entity Types (5)
+\`advertiser\`, \`campaign\`, \`adGroup\`, \`creative\`, \`conversionTracker\`
+
+**GraphQL-only entities:** Ads (adGroup + creative), deals, bid lists, and publisher lists (site lists) must be managed via \`ttd_graphql_query\`.
+
+---
+
+## Context-Minimization Rules
+
+- Summarize fetched resources in your own words instead of pasting full content
+- Reuse facts from previous tool calls instead of re-fetching
+- Start with one tool call, inspect results, then decide next steps
+- Avoid requesting \`://all\` resources unless you need a complete overview
+
+## Suggested Next Steps
+- For campaign setup: invoke \`ttd_campaign_setup_workflow\` prompt
+- For reporting: invoke \`ttd_report_generation_workflow\` prompt
+- For debugging: invoke \`ttd_troubleshoot_entity\` prompt
+- For bulk operations: use \`ttd_bulk_create_entities\` or \`ttd_bulk_update_entities\`
+- For rich entity queries: use \`ttd_graphql_query\` for nested data
+- For bid optimization: use \`ttd_adjust_bids\` for safe read-modify-write
+`;
+}
+//# sourceMappingURL=tool-schema-exploration.prompt.js.map

package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-exploration.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/tool-schema-exploration.prompt.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,2BAA2B,GAAW;IACjD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,gHAAgH;IAClH,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,6EAA6E;YAC1F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,+BAA+B,CAAC,IAA6B;IAC3E,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,8BAA8B,CAAC;IAEpE,OAAO;;;;eAIM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6KvB,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const troubleshootEntityPrompt: Prompt;
+export declare function getTroubleshootEntityMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=troubleshoot-entity.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshoot-entity.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/troubleshoot-entity.prompt.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,wBAAwB,EAAE,MAWtC,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA2GlF"}