line_item_get

Read one Line Item with its readiness: if AdCrunch can build it now, and why not when it cannot.

Ask the agent to look at one Line Item, and to check that AdCrunch can build it before the agent 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_get. You see the Line Item with its name, its money in the currency of the Campaign Plan, its dates and what it created. You also see its 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 agent names one reason and tells you what to do: for example, choose an ad account in the currency of the Campaign Plan. AdCrunch never converts a currency.

When a person must validate the Line Item, the agent gives you the link to the page of the Line Item in the AdCrunch console. The readiness 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

Fetch one Line Item of a Campaign Plan, by the slug of the Campaign Plan and the id of the Line Item. line_item_list lists the Line Items and gives their ids. The answer has the fields of the Line Item as line_item_list returns it, with what it already created, and beside them consoleUrl, currency and readiness. status is the status of the Line Item, and readiness.status is the verdict. currency is the currency of the Campaign Plan, and each amount of the Line Item is in whole units of it. readiness answers whether AdCrunch can build the Line Item now, and why not when it cannot. Call it before you build a Line Item with a provider write tool, such as meta_create_campaign. It reads the Context store and the ad account that AdCrunch stores, and it calls no provider. readiness.status is ready, or it names the first reason: a person has not validated the Line Item in the AdCrunch console (not_validated), AdCrunch cannot write to the channel (channel_not_executable), the Line Item names no ad account (no_advertiser), the ad account is not connected (advertiser_not_owned), the ad account belongs to another provider (provider_mismatch), AdCrunch does not know the currency of the ad account (account_currency_unknown), the currencies differ (currency_mismatch), the dates are missing (no_window), or the dates are in the wrong order (window_inverted). For no_advertiser, advertiser_not_owned, provider_mismatch and currency_mismatch, set advertiser_id with line_item_update: list_advertisers gives the ad accounts. For no_window and window_inverted, give dates with line_item_update or campaign_plan_update. For not_validated, a person validates the Line Item, or approves the Campaign Plan, in the AdCrunch console: give consoleUrl, the page of the Line Item, to the user. For account_currency_unknown, a person refreshes the provider connection in the AdCrunch console. For channel_not_executable, tell the user that AdCrunch cannot build the Line Item. When the status is ready, readiness 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. readiness is advice: the provider write tools do not read it. AdCrunch never converts a currency. Echo revision back as base_revision when you write to the Line Item.

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/line-items/lni_2d9e77",
  "advertiserId": "acc_1203456789012345",
  "ageMax": 44,
  "ageMin": 25,
  "budget": 2500,
  "campaignPlanId": "cpl_4e1a08",
  "channel": "meta",
  "countries": [
    "FR",
    "BE"
  ],
  "createdAt": 1768435200000,
  "createdBy": "usr_5d2b71",
  "effectiveEndDate": "2026-05-31",
  "effectiveStartDate": "2026-03-01",
  "endDate": null,
  "executable": true,
  "executions": [
    {
      "advertiserId": "acc_1203456789012345",
      "createdAt": 1772409600000,
      "entityId": "120210000000000",
      "entityType": "campaign",
      "id": "exe_7a4c12",
      "mutationId": "mut_k3x9q2v7m4n8p1r5t6w0y2z4",
      "provider": "meta"
    }
  ],
  "gender": "all",
  "id": "lni_2d9e77",
  "name": "France and Belgium, parents",
  "objective": "sales",
  "personaId": "psn_8c4a20",
  "provider": "meta",
  "revision": 2,
  "startDate": null,
  "status": "validated",
  "targetMetric": "cpa",
  "targetValue": 24.5,
  "unit": "total",
  "updatedAt": 1769040000000,
  "currency": "EUR",
  "readiness": {
    "advertiserId": "acc_1203456789012345",
    "budget": 2500,
    "currency": "EUR",
    "endDate": "2026-05-31",
    "provider": "meta",
    "startDate": "2026-03-01",
    "status": "ready",
    "unit": "total"
  }
}