Skip to main content
Docs navigation

MCP server

Connect Claude, Cursor, Codex, or any MCP client straight to your NextWave site.

The NextWave MCP server (binary nwp-mcp, server name nextwave) exposes every NextWave operation as a tool your agent can call, plus a set of teaching resources it can read. It connects to your own WordPress site with the same site URL and Application Password the CLI uses.

Add to Claude Code

One command registers the server with your connection baked in:

bash
$ claude mcp add nextwave \$   -e WORDPRESS_SITE_URL=https://members.example.com \$   -e WORDPRESS_USERNAME=jane@example.com \$   -e WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" \$   -- npx -y @island-pitch/nextwave-mcp

Add to Cursor / Claude Desktop / Codex

For clients that read an mcpServers config (Cursor's mcp.json, Claude Desktop, and similar), drop in this block and fill in your own values:

json
{
  "mcpServers": {
    "nextwave": {
      "command": "npx",
      "args": ["-y", "@island-pitch/nextwave-mcp"],
      "env": {
        "WORDPRESS_SITE_URL": "https://members.example.com",
        "WORDPRESS_USERNAME": "jane@example.com",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Environment variables

The server needs the same three credentials as the CLI:

VariablePurpose
WORDPRESS_SITE_URLYour site's base URL; the server appends /wp-json/nwp/v1.
WORDPRESS_USERNAMEThe user the Application Password belongs to.
WORDPRESS_APP_PASSWORDThe WordPress Application Password (keep the spaces; quote it).

Tools exposed

The server publishes 131 tools, named nwp_<resource>_<action> — for example nwp_members_list, nwp_benefits_create, or nwp_redemptions_get. They cover the same resource groups as the CLI, so anything you can do at the terminal an agent can do through the tools.

Resources

Beyond tools, the server serves teaching material your agent can read before it acts — so it learns the membership model and error contract instead of guessing:

  • nextwave://api/catalog — the full operation catalog, agent-readable.
  • nextwave://api/catalog.json — the same catalog as machine-readable JSON.
  • nextwave://guide/agent-workflows — recipes for common multi-step tasks.
  • nextwave://schema/errors — the error model and what each code means.

Self-hosted

The endpoint the server talks to is your own site (WORDPRESS_SITE_URL), not a shared NextWave host. The connected WordPress user's capabilities decide what every tool is allowed to do.