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:pillarheads a theme,satellitehangs under the pillar whose id is inparent.action:create,rework,merge(the pages inmergeFromfold into this one) orsplit(the page insplitFromhands 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,nullwhen 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
whyandopportunityinto one or two sentences, then givelink. - Undo a decision. A
mission_closedmission comes back with set_recommendation_status andstatus: "todo".
Related tools
- list_content_plan: the whole plan in order.
- get_content_map: where the page sits in its theme.
- set_recommendation_status: mark the mission done or excluded.