Skip to main content
Glama

Get Delivery Estimate

adsap_get_delivery_estimate

Get Meta's delivery estimate for a proposed audience and optimization configuration. Returns estimated daily reach, outcome ranges, audience size assessment (too_narrow/narrow/moderate/broad/very_broad). Use during onboarding to validate strategies or in audits to check targeting breadth.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
daily_budgetNoDaily budget in cents. If provided, estimates are budget-constrained.
ad_account_idYesMust include act_ prefix.
targeting_specYesTargeting specification. Must include at least countries.
promoted_objectNoRequired for conversion goals. E.g. { pixel_id: '123', custom_event_type: 'Purchase' }
optimization_goalYesOptimization goal for the estimate.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the behavioral disclosure burden. It transparently describes the return values (estimated daily reach, outcome ranges, audience size assessment) and implies a non-mutating read operation through 'Get' and 'Returns.' It does not discuss auth or rate limits, but for an estimation tool these are less critical.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, each earning its place: purpose, return values, use contexts. No fluff, no repetition, and the core purpose is front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the absence of an output schema, the description adequately covers what the caller gets back. Combined with a fully documented input schema, the agent has enough to invoke the tool correctly without opening schemas further.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema coverage is 100%, so the schema already documents all parameters. The description adds only a high-level summary ('proposed audience and optimization configuration') and does not clarify parameter nuances beyond the schema. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb and resource ('Get Meta's delivery estimate') and clearly differentiates it from sibling tools like adsap_get_insights or adsap_get_pixel_stats by stating it returns delivery estimates and audience size assessment. This makes the tool's purpose unmistakable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly states when to use it: 'during onboarding to validate strategies or in audits to check targeting breadth.' It does not name alternatives or exclusions, but the context is clear enough for an agent to select it appropriately.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources