[{"data":1,"prerenderedAt":341},["ShallowReactive",2],{"navigation_docs":3,"-troubleshooting-wordpress-tool-failed":79,"-troubleshooting-wordpress-tool-failed-surround":338},[4,35,44,69],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Start here",false,"\u002Fgetting-started","1.getting-started",[10,15,20,25,30],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-arrow-right",{"title":21,"path":22,"stem":23,"icon":24},"Install the plugin","\u002Fgetting-started\u002Finstall-plugin","1.getting-started\u002F3.install-plugin","i-lucide-download",{"title":26,"path":27,"stem":28,"icon":29},"Connect a website","\u002Fgetting-started\u002Fconnect-website","1.getting-started\u002F4.connect-website","i-lucide-link",{"title":31,"path":32,"stem":33,"icon":34},"Connect an Agent","\u002Fgetting-started\u002Fconnect-agent","1.getting-started\u002F5.connect-agent","i-lucide-plug",{"title":31,"icon":6,"path":36,"stem":37,"children":38,"page":6},"\u002Fagents","2.agents",[39],{"title":40,"path":41,"stem":42,"icon":43},"Codex","\u002Fagents\u002Fcodex","2.agents\u002F1.codex","i-lucide-code",{"title":45,"icon":6,"path":46,"stem":47,"children":48,"page":6},"Use MoraWP","\u002Fguides","3.guides",[49,54,59,64],{"title":50,"path":51,"stem":52,"icon":53},"Websites","\u002Fguides\u002Fwebsites","3.guides\u002F1.websites","i-lucide-cloud",{"title":55,"path":56,"stem":57,"icon":58},"Agents","\u002Fguides\u002Fagents","3.guides\u002F2.agents","i-lucide-sparkles",{"title":60,"path":61,"stem":62,"icon":63},"Abilities","\u002Fguides\u002Fabilities","3.guides\u002F3.abilities","i-lucide-wrench",{"title":65,"path":66,"stem":67,"icon":68},"Activity","\u002Fguides\u002Factivity","3.guides\u002F4.activity","i-lucide-history",{"title":70,"icon":6,"path":71,"stem":72,"children":73,"page":6},"Troubleshooting","\u002Ftroubleshooting","4.troubleshooting",[74],{"title":75,"path":76,"stem":77,"icon":78},"WordPress tool failed","\u002Ftroubleshooting\u002Fwordpress-tool-failed","4.troubleshooting\u002F1.wordpress-tool-failed","i-lucide-alert-circle",{"id":80,"title":75,"body":81,"description":331,"extension":332,"links":333,"meta":334,"navigation":335,"path":76,"seo":336,"stem":77,"__hash__":337},"docs\u002F4.troubleshooting\u002F1.wordpress-tool-failed.md",{"type":82,"value":83,"toc":317},"minimark",[84,92,96,101,104,111,114,118,125,131,150,154,157,167,174,179,186,190,201,205,208,212,215,218,224,228,302,306,309],[85,86,87,91],"p",{},[88,89,90],"code",{},"WORDPRESS_MORAWP_TOOL_FAILED"," means WordPress or the MoraWP Plugin returned a\ntool failure. It is a category of error, not the underlying diagnosis. The code\nalone does not tell you whether an identifier was wrong, an Integration rejected\nthe request, or a WordPress operation failed.",[93,94,95],"warning",{},"For an action that can change your website, an error does not prove that nothing\nchanged. Check WordPress before repeating the action. A second attempt could\ncreate duplicate content or repeat a partial change.",[97,98,100],"h2",{"id":99},"_1-keep-the-error-details","1. Keep the error details",[85,102,103],{},"Ask your Agent for the tool response from the failed call, including the\nmessage, Ability name, target website, and any request identifier. Note the\ntime and the installed MoraWP Plugin and relevant Integration versions.",[85,105,106,107,110],{},"Use ",[108,109,65],"strong",{}," to identify the corresponding execution. Include additional\nWordPress error details only when the response actually provides them; some\nfailures return a generic message.",[85,112,113],{},"Do not share tokens, credentials, authorization headers, or private page content\nwhen asking for help.",[97,115,117],{"id":116},"_2-check-what-actually-happened","2. Check what actually happened",[85,119,120,121,124],{},"For a ",[108,122,123],{},"read",", open the requested item in WordPress. Confirm that it exists on\nthe same website and that you used the correct identifier and item type.",[85,126,120,127,130],{},[108,128,129],{},"change",", inspect the specific result: the post's current values, created\nitems, affected settings, or relevant files. If you cannot establish the state,\nstop further changes and ask the website administrator to investigate.",[85,132,133,134,137,138,141,142,145,146,149],{},"Structured Agent responses may include ",[88,135,136],{},"mayHaveExecuted",", ",[88,139,140],{},"outcomeKnown",", and\n",[88,143,144],{},"retrySafe",". A known failure response is not a guarantee that a multi-step\noperation left the website unchanged. Do not override ",[88,147,148],{},"retrySafe: false"," by\nautomatically repeating the call.",[97,151,153],{"id":152},"_3-discover-the-current-ability","3. Discover the current Ability",[85,155,156],{},"Ask the Agent to inspect the site's current inventory and the selected Ability's\ninput schema before changing the request:",[158,159,165],"pre",{"className":160,"code":162,"language":163,"meta":164},[161],"language-text","Inspect the failed MoraWP request without repeating it. Use\nmorawp_list_abilities to find the Ability on this website, then call\nmorawp_get_ability_info for its current input schema. Compare the failed\nparameters with that schema and explain the WordPress error if the response\nincludes one. Do not run a write or remove dry_run automatically.\n","text","",[88,166,162],{"__ignoreMap":164},[85,168,169,170,173],{},"These are MCP tools, not Ability IDs. Call them directly rather than passing\ntheir names to ",[88,171,172],{},"morawp_execute_ability",".",[175,176,178],"h3",{"id":177},"reading-a-post-or-page","Reading a post or page",[85,180,181,182,185],{},"For a failed ",[88,183,184],{},"morawp\u002Fwordpress-core-get-post"," request, obtain the identifier\nfrom the same website's post or page list. A WordPress ID from another website,\na URL, or a title is not interchangeable with the identifier required by the\ncurrent schema.",[175,187,189],{"id":188},"reading-elementor-content","Reading Elementor content",[85,191,192,193,196,197,200],{},"For ",[88,194,195],{},"morawp\u002Fpage-builders-elementor-get-content"," or\n",[88,198,199],{},"morawp\u002Fpage-builders-elementor-get-schema",", confirm that Elementor is installed\nand detected on that website. For content reads, verify the selected item is\nthe Elementor document you intended to inspect. Use the discovered schema;\ndo not substitute a remembered parameter name from a different release.",[175,202,204],{"id":203},"running-php-or-wp-cli","Running PHP or WP-CLI",[85,206,207],{},"For PHP or WP-CLI failures, inspect the actual code or command and its returned\nerror. These tools can affect the website. Ask an administrator to check the\nenvironment or operation rather than running another broad command to guess\nthe cause.",[97,209,211],{"id":210},"_4-retry-only-after-checking","4. Retry only after checking",[85,213,214],{},"For a read, correct the confirmed input or compatibility problem and retry that\nspecific request. For a change, first establish what completed and what remains,\nthen agree on the next action with the person responsible for the website.",[85,216,217],{},"Updating the MoraWP Plugin may resolve a confirmed compatibility problem, but\nthis generic error alone does not prove that an update is the fix. After an\nupdate, discover the site's Abilities again.",[85,219,220,223],{},[108,221,222],{},"Success check:"," the intended read returns the correct item, or the intended\nchange is verified in WordPress. An Agent's summary alone is not that check.",[97,225,227],{"id":226},"errors-with-a-different-next-step","Errors with a different next step",[229,230,231,244],"table",{},[232,233,234],"thead",{},[235,236,237,241],"tr",{},[238,239,240],"th",{},"Code",[238,242,243],{},"Meaning and next step",[245,246,247,258,272,282,292],"tbody",{},[235,248,249,255],{},[250,251,252],"td",{},[88,253,254],{},"AGENT_ABILITY_MODE_DENIED",[250,256,257],{},"The Ability is outside this Agent's access mode. Review access in MoraWP; do not retry unchanged.",[235,259,260,265],{},[250,261,262],{},[88,263,264],{},"MCP_DRY_RUN_UNSUPPORTED",[250,266,267,268,271],{},"The Ability does not support a dry run. Do not silently remove ",[88,269,270],{},"dry_run"," from a change; review the operation first.",[235,273,274,279],{},[250,275,276],{},[88,277,278],{},"MORAWP_PLUGIN_INCOMPATIBLE",[250,280,281],{},"The installed plugin does not meet the Ability's version requirement. Follow the version in the response and update before rediscovery.",[235,283,284,289],{},[250,285,286],{},[88,287,288],{},"MCP_ABILITY_NOT_FOUND",[250,290,291],{},"Discover the site's current inventory and use the returned namespaced Ability ID.",[235,293,294,299],{},[250,295,296],{},[88,297,298],{},"WORDPRESS_EXECUTION_OUTCOME_UNKNOWN",[250,300,301],{},"MoraWP cannot confirm the result of a dispatched change. Inspect the website before any retry.",[97,303,305],{"id":304},"when-to-ask-for-help","When to ask for help",[85,307,308],{},"If a valid read still fails, prepare the website, time, Ability ID, request\nidentifier if available, plugin and Integration versions, and the non-sensitive\nerror message. If a change may have partially completed, include what you\nverified in WordPress and pause further attempts until its state is understood.",[85,310,311,312,316],{},"Review ",[313,314,315],"a",{"href":66},"Activity and AI Actions"," to understand why a dispatched\nattempt can count even when WordPress returns an error.",{"title":164,"searchDepth":318,"depth":318,"links":319},2,[320,321,322,328,329,330],{"id":99,"depth":318,"text":100},{"id":116,"depth":318,"text":117},{"id":152,"depth":318,"text":153,"children":323},[324,326,327],{"id":177,"depth":325,"text":178},3,{"id":188,"depth":325,"text":189},{"id":203,"depth":325,"text":204},{"id":210,"depth":318,"text":211},{"id":226,"depth":318,"text":227},{"id":304,"depth":318,"text":305},"Find the cause of WORDPRESS_MORAWP_TOOL_FAILED and decide what to do before retrying.","md",null,{},{"icon":78},{"title":75,"description":331},"RrQTyal9MFmhXlNZI7Lo_-YPOFvy4GBzdAlok-TKFgk",[339,333],{"title":65,"path":66,"stem":67,"description":340,"icon":68,"children":-1},"See what Agents did, where they did it, and whether it worked.",1791233584332]