Setup
Assistant
Diagnose your MCP connection, walk through first-time setup, and fix common problems. Works even when Respira is broken — it is the skill you run first.
Read-only · No changes made · Works without active Respira connection · Free with any plan
$ npx @respira/wordpress-mcp-server --doctor
┌───────────────────────────────────────┐
│ Respira MCP Doctor │
└───────────────────────────────────────┘
✓ Node.js v22.4.0
✓ MCP server v5.5.0
✓ Config found (1 site)
✓ Default site: example.com
✓ Connection OK (287ms)
✓ Plugin v5.5.0
✓ Version compatible
✓ API v2 negotiated
✓ Up to date
All 9 checks passed.What it does
Doctor Diagnostics
9 checks in one pass — Node.js version, MCP config, connectivity, plugin version, API negotiation, and npm update availability.
Version Compatibility
Detects version mismatches between MCP server and plugin. Tells you exactly what to update and why.
Guided Setup
Walks through first-time connection step by step — plugin install, API key creation, MCP configuration.
Troubleshooting
Resolves timeouts, 401s, 403s, staging auth issues, and REST API blocks with plain-language instructions.
How it works
- 1
Trigger the Skill
Tell your AI agent: "set up respira", "fix respira", or "check my respira connection".
- 2
Run Doctor Check
Calls respira_get_server_compatibility to test connectivity and version compatibility in one request.
- 3
Diagnose Issues
Identifies the exact failure: missing plugin, no API key, version mismatch, auth error, or network problem.
- 4
Guide to Resolution
Provides step-by-step instructions tailored to the specific issue found.
- 5
Verify Fix
Re-runs the check to confirm the connection is healthy before handing off to other skills.
Trigger phrases
Say any of these to your AI agent to activate the Setup Assistant:
What it fixes
Common connection problems and how the skill resolves each one:
Timeout / ECONNREFUSED
Site URL is wrong, firewall blocks requests, or WordPress is down. Skill verifies URL and suggests fixes.
401 Unauthorized
API key is missing, invalid, or expired. Skill guides through key creation in WordPress admin.
403 Forbidden
Security plugin blocking REST API, or .htaccess rules denying access. Skill identifies the blocker.
Version Mismatch
MCP server and plugin versions are incompatible. Skill shows which to update and the exact command.
Staging Auth (HTTP 401)
Staging sites often have HTTP Basic Auth. Skill detects this and shows how to configure credentials.
REST API Disabled
Some hosts or security plugins disable the REST API. Skill checks and provides re-enablement instructions.
Quick health check from the terminal
Run the doctor command directly without using an AI agent:
npx @respira/wordpress-mcp-server --doctor Add --json for machine-readable output.
Get started
The Setup Assistant works with any Respira plan, including the free Lite tier. Install the skill and run your first diagnostic in under a minute.
Share this skill
Community feedback
Community ratings
Rate this skill and share what worked (or what needs to improve).
Community rating
—
/ 5
0 ratings
Community Ratings
Showing: Most helpful
