get_content_mission

get_content_mission MCP tool: one open mission of the content plan with its full reason. For a page: theme, role, format, main query, effort and the components of its opportunity score.

Updated 2026-10-17

get_content_mission returns one open mission of the content plan by its id, with everything that explains why it is there. For a page mission, that includes the opportunity score and its components: monthly traffic at the target position, target and current Google position, and how many results of the top 10 belong to stronger sites. Fixes, sources, local areas and local actions return their kind, title, reason and the app page that holds them.

When to use

When the user asks "why this page?" or "why now?" about a mission of list_content_plan. The score is computed in code from search demand, intent, cost per click, the user's offers, AI answers and fan-out queries, divided by the effort: the components let an agent explain it in plain words.

Input

Field Type Default Description
projectId string (CUID) required Project scope.
id string required A mission id from list_content_plan or get_content_map (content:…, page:…, fix:…, source:…, or a local action such as website or reviews_count).

Response

{
  "success": true,
  "id": "page:example.com/crm-pricing",
  "period": "month",
  "month": "2026-10",
  "kind": "page",
  "title": "Rework /crm-pricing",
  "why": [
    "Offer page",
    "you already rank 8th: a quick win",
    "tied to your offer CRM for freelancers",
    "~220 visits/month potential"
  ],
  "link": "/p/cmg7z0q1p0001l70f8h3k5m1n/site/url/aHR0cHM6Ly9leGFtcGxlLmNvbS9jcm0tcHJpY2luZw",
  "step": "commercial",
  "started": false,
  "theme": "CRM for freelancers",
  "role": "pillar",
  "parent": null,
  "action": "rework",
  "format": "offer_page",
  "url": "https://example.com/crm-pricing",
  "slug": null,
  "mergeFrom": [],
  "splitFrom": null,
  "mainQuery": "crm for freelancers",
  "effort": "M",
  "withFix": true,
  "peakMonth": null,
  "opportunity": {
    "score": 61.3,
    "traffic": 220,
    "position": 3,
    "stronger": 2,
    "current": 8
  }
}
  • role: pillar heads a theme, satellite hangs under the pillar whose id is in parent.
  • action: create, rework, merge (the pages in mergeFrom fold into this one) or split (the page in splitFrom hands part of its content to this one).
  • withFix: the page's Site health fix is folded into this mission. peakMonth: month of peak demand (January = 0) when demand is clearly seasonal.
  • opportunity.position: the position aimed for, 11 meaning outside the first page. current: the site's position today, null when it does not rank. stronger: results of the top 10 held by sites with clearly more organic traffic.
  • The writing brief (angle, headings, queries, anchors) never leaves the server: it feeds the page generation in the app.

Errors

error When
no_content_plan No strategy computed yet for this project.
mission_closed The mission is done or excluded. status says which (done or excluded).
mission_not_found No mission with this id in the plan.

Tips and patterns

  • Explain, then point. Turn why and opportunity into one or two sentences, then give link.
  • Undo a decision. A mission_closed mission comes back with set_recommendation_status and status: "todo".

Related tools

You can see where you stand today.

Free trial. Start tracking your AI visibility, no credit card.