line_item_readiness

Check whether AdCrunch can build a Line Item now, and if it cannot, why and what to do.

Ask the agent to check a Line Item before it builds it on Meta. The Meta tools do not read your Campaign Plan, so this check is how the agent finds a problem before it spends.

“Can you build the Meta Line Item of the spring sale Campaign Plan now?”

The agent calls line_item_readiness. When the Line Item is ready, the answer gives the dates that apply, the budget, and whether the budget goes to Meta as a lifetime total or as a daily rate. When it is not ready, the answer names one reason and gives the fix: for example, an ad account in a different currency. AdCrunch never converts a currency.

When a person must validate the Line Item, the agent gives you the link to the page of the Campaign Plan in the AdCrunch console. The check is advice: the Meta tools do not read it, so AdCrunch does not refuse to build a Line Item that is not ready.

Plan a campaign walks the whole job.

Reference

Check whether AdCrunch can build a Line Item now, and if it cannot, why. Call it before you build a Line Item with a provider write tool, such as meta_create_campaign. It reads, it changes nothing, and it calls no provider. readiness.status is ready, or it names one reason: a person has not validated the Line Item in the AdCrunch console, AdCrunch cannot write to the channel, the Line Item names no ad account, the ad account is not connected, the ad account belongs to another provider, AdCrunch does not know the currency of the ad account, the currencies differ, or the dates are missing or in the wrong order. fix tells you what to do about the reason. consoleUrl is the page of the Campaign Plan: give it to the user when a person must act there. When the Line Item is ready, the answer gives the dates that apply, and it tells you whether the budget goes to the provider as a lifetime total or as a daily rate. This answer is advice: the provider write tools do not read it. AdCrunch never converts a currency.

Input

Output

A successful call returns this object in structuredContent.

Failure codes

A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.

• not_found
• organization_unentitled
• forbidden
• invalid_request
• internal_error

Scope

The token must hold campaign_plan:read. Auth & scopes lists each scope.

Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

• Read-only. The tool changes nothing.
• Closed world. The tool reads and writes the data of AdCrunch only.

Example

The arguments:

{
  "campaign_plan_name": "spring-sale",
  "line_item_id": "lni_2d9e77"
}

The result, in structuredContent:

{
  "consoleUrl": "https://console.adcrunch.dev/campaign-plans/spring-sale",
  "fix": null,
  "readiness": {
    "advertiserId": "acc_1203456789012345",
    "budget": 2500,
    "currency": "EUR",
    "endDate": "2026-05-31",
    "provider": "meta",
    "startDate": "2026-03-01",
    "status": "ready",
    "unit": "total"
  }
}