// MCP TOOL REFERENCE

WP ASTRO MCP TOOLS

60 tools from the WP Astro MCP MCP Server, categorised by risk level.

// ALL 60 WP ASTRO MCP TOOLS

READ 30 tools

Read cache_authors Fetch ALL authors and cache them in SQLite. Should be run before a full export for fast author lookups. Cac... Read cache_terms Fetch ALL terms for ALL taxonomies and cache them in SQLite. Should be run before a full export for fast te... Read content_audit Sample posts and analyze content patterns: detect shortcodes, Gutenberg blocks, page builders, embeds, gall... Read extract_all_ids Fetch post IDs for a post type (lightweight). Used for two-phase fetch strategy on large sites. Returns a b... Read extract_authors Fetch authors/users from the site. Returns a bounded page (default 1000, max 10000) plus total/has_more/nex... Read extract_comments Fetch approved comments, optionally filtered by post ID. Read extract_media Fetch media items. Either a specific item by ID or paginated list. Read extract_menus Fetch navigation menus and menu items. Works with WP 5.9+ navigation blocks and classic menus. Read extract_post Fetch a single post by ID with full content (edit context), embedded data, and content analysis (shortcodes... Read extract_posts Fetch posts from WordPress with pagination. Supports any post type, status filters, date filters. Returns p... Read extract_settings Fetch site settings (title, tagline, timezone, date/time formats, permalink structure, language). Read extract_terms Fetch taxonomy terms (categories, tags, or custom taxonomies) with pagination. Read extract_widgets Fetch sidebar/widget areas and their widgets (WP 5.8+). Read github_status Show git status of the output directory (branch, changes, remote). Read list_output List all files in the output directory with stats (file count, total size, content types). Read shortcode_list List all configured shortcode handling rules for a site. Read shortcode_scan Scan posts for all shortcodes in use and return a report. Helps identify which shortcodes need configuratio... Read site_analyze Deep analysis of a WordPress site: count all content types, detect plugins, audit shortcodes, check media, ... Read site_get Get full details for a specific site including detected capabilities and export config. Read site_list List all registered WordPress sites with status and content stats. Read site_test Test connection to a site and refresh detected capabilities. Read sync_check Compare WordPress content against local exported files. Reports new posts, updated posts (content/SEO/image... Read sync_status Show sync history: last sync time, number of posts synced, changes made. Helps track when the Astro site wa... Read wp_astro_describe Get the full input schema for a specific action. Read wp_astro_help List available actions, optionally filtered by category. Read convert_preview Convert a sample of posts to preview Markdown output. Shows frontmatter structure and content quality befor... Read export_plan Generate a full export plan: content counts by type, estimated time, recommended batch size, and pre-flight... Read export_progress Show progress of an export job: completion percentage, posts done/failed/pending, estimated time remaining. Read export_validate Validate an export job: check all output files exist, report issues, and verify completeness. Read media_audit Scan exported Markdown files for media references. Reports domains, counts, and broken references. Use befo...

WRITE 20 tools

Write github_deploy_config Generate deploy platform configuration (Vercel, Netlify, or Cloudflare Pages). Write scaffold_project Create an Astro project structure: package.json, astro.config, layouts, content collections, pages, RSS fee... Write convert_html Convert raw HTML to Markdown. Useful for testing conversion rules or converting arbitrary HTML content. Write convert_post Convert a single WordPress post to Astro Markdown. Returns full frontmatter + body with conversion issues r... Write export_start Start a full batch export. Creates a job in SQLite, fetches all post IDs, and begins processing in batches.... Write generate_redirects Generate a redirects file from the WordPress→Astro URL map. Supports Netlify, Vercel, Cloudflare, Apache, a... Write github_commit Stage all changes and create a commit in the output directory. Write github_create_repo Create a GitHub repository and set it as the remote origin. Requires github_token in config. Write github_init Initialize a git repository in the output directory. Creates .gitignore and initial commit. Write media_rewrite Bulk rewrite media URLs in all exported content files. Replaces one domain with another (e.g., example.com ... Write shortcode_configure Configure how a specific shortcode should be handled during conversion. Actions: strip (remove entirely), k... Write site_add Register a new WordPress site. Requires URL, username, and application password. Auto-detects WP version, S... Write site_export_config Configure export settings for a site: output directory, content format, media strategy, post type filters, ... Write site_set_default Set a site as the default (used when site_id is omitted). Write site_update Update site credentials or settings. Write sync_pull Fetch and write only changed content from WordPress. Creates new files for new posts, overwrites files for ... Write sync_schedule Generate automated sync configuration: GitHub Actions workflow, cron job, or platform-specific webhook. Kee... Write sync_webhook Process a webhook from wp-astro-bridge. Validates signature, syncs the specific post (fetch, convert, write... Write write_batch Convert and write a page of posts to disk. Use with pagination for incremental writing. Supports dry_run mode. Write write_post Convert a single WordPress post and write it as a Markdown file to the Astro content directory. Supports dr...

DESTRUCTIVE 5 tools

Destructive site_remove Deactivate a site (soft delete, can be reactivated). Destructive sync_delete Remove local Markdown files for posts that have been deleted or trashed in WordPress. Also cleans up URL ma... Destructive sync_full Complete content sync: check for changes → pull new/updated posts → delete removed posts → update caches → ... Destructive sync_reset Clear sync tracking data to force a full re-sync on next sync_pull. Does not delete content files. Destructive export_cleanup Delete export job data from database (does not delete files). Requires confirm=true.

EXECUTE 5 tools

Execute wp_astro_run Execute a WordPress-to-Astro frontend action. Use wp_astro_help to list available actions. Common workflow... Execute export_resume Resume an in-progress export. Processes the next batch of pending posts. Call repeatedly until complete. Execute export_retry Retry all failed posts in an export job. Execute github_push Push commits to the remote repository. Execute setup_wizard Guided setup: register a WordPress site, analyze content, configure export, scaffold an Astro project, expo...

// FAQ

How many tools does the WP Astro MCP MCP server have? +

The WP Astro MCP MCP server exposes 60 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on WP Astro MCP tools? +

Route the WP Astro MCP server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do WP Astro MCP tools fall into? +

WP Astro MCP tools are categorised as Read (30), Write (20), Destructive (5), Execute (5). Each category has a recommended default policy.

Enforce policy on every WP Astro MCP tool call.

Start from WP Astro MCP, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.