MCP Server

Prompts Reference

Guided workflows with WPNuxt MCP prompts

Prompts provide guided workflows for common tasks. They help you interact with the MCP server through natural conversation.

connect-wordpress

Connect to a WordPress site and explore available content.

This prompt guides you through:

  1. Connecting to your WordPress site
  2. Listing available content types
  3. Showing configured menus
  4. Detecting installed plugins
  5. Listing available WPNuxt composables

Input:

NameTypeRequiredDescription
wordpressUrlstringYesYour WordPress site URL

Example conversation:

You: Use the connect-wordpress prompt with https://wordpress.wpnuxt.com

AI: I'll connect to your WordPress site and analyze what's available...

Connected to: WordPress WPNuxt Demo

Content Types:

  • Posts (post)
  • Pages (page)
  • Products (product) - WooCommerce

Menus:

  • Main Navigation (3 items)
  • Footer Menu (5 items)

Detected Plugins:

  • WPGraphQL
  • WooCommerce
  • Yoast SEO

Would you like me to generate a WPNuxt project based on this WordPress site?


switch-wordpress

Switch to a different WordPress site or check current connection.

Use this prompt when you need to:

  • Switch to a different WordPress site
  • Check which site you're currently connected to
  • Troubleshoot connection issues

Input:

NameTypeRequiredDescription
newWordpressUrlstringNoNew WordPress URL (leave empty to check status)

Example: Checking connection status

You: Use the switch-wordpress prompt (without URL)

AI: You're currently connected to:

Would you like to continue with this site or switch to a different one?

Example: Switching sites

You: Use the switch-wordpress prompt with https://my-other-site.com

AI: Switching to https://my-other-site.com...

Connected to: My Other WordPress Site

Content Types available:

  • Posts (12 published)
  • Pages (5 published)
  • Portfolio (custom post type, 8 items)

This site has a Portfolio custom post type that wasn't on your previous site. Would you like me to generate queries and pages for it?


Chaining Prompts

You can chain prompts together for a complete workflow. Here's an example:

  1. Connect to your WordPress site:

    Use connect-wordpress with https://my-site.com

  2. Explore the content structure, then ask the AI to generate a project:

    Generate a WPNuxt project based on this site

  3. Switch to a staging site to test:

    Use switch-wordpress with https://staging.my-site.com

  4. Compare content between the two sites:

    How does this site's content differ from the previous one?

The AI maintains context across the conversation, so it can compare content structures, suggest changes, and generate code that works with both environments.


Using Prompts

In Claude Desktop

Click the prompt button (📎) and select a WPNuxt prompt from the list.

In Claude Code

Prompts are available through the MCP integration. Simply describe what you want to do:

Connect me to my WordPress site at https://example.com

The AI will automatically use the appropriate prompt and tools.

In Custom MCP Clients

Request a prompt programmatically:

const response = await client.getPrompt('connect-wordpress', {
  wordpressUrl: 'https://example.com'
})

Troubleshooting

"WordPress site not found" after connecting

The MCP server validates the URL by checking for a WPGraphQL endpoint. Make sure:

  • The URL is correct (no trailing slash needed)
  • WPGraphQL is installed and activated
  • The GraphQL endpoint is accessible (try visiting https://your-site.com/graphql in a browser)

Prompts not showing up in Claude Desktop

  1. Verify your MCP configuration in Claude Desktop settings
  2. Check that the WPNuxt MCP server URL is reachable: https://wpnuxt.com/mcp
  3. Restart Claude Desktop after changing the configuration

"No content types found"

This usually means WPGraphQL is installed but no content is published. Verify:

  • You have at least one published post or page
  • Your WordPress user has read permissions
  • Custom post types are registered with show_in_graphql: true
Copyright © 2026