Skip to content
Volāre Documentation

Required MCP Servers

This project’s MCP (Model Context Protocol) servers are defined in the root .mcp.json file and load automatically: .claude/settings.json sets "enableAllProjectMcpServers": true, so no manual claude mcp add step is needed.

Laravel Boost MCP

Section titled “Laravel Boost MCP”

Purpose: Laravel development tools - database access, Artisan commands, error logs, Tinker execution, and documentation search.

How it runs: Laravel Boost is a Composer dev dependency (laravel/boost v2 in backend/composer.json). The server is wired in .mcp.json as:

Terminal window
cd backend && ./vendor/bin/sail artisan boost:mcp

Sail containers must be running for the server to start.

Used By: All backend agents (@laravel-core-agent, @filament-admin-agent, @laravel-testing-agent, @laravel-debug-agent)

Key Tools:

  • application-info - Get app info, packages, models
  • database-schema - Read complete database schema
  • database-query - Execute read-only SQL queries
  • search-docs - Search Laravel ecosystem docs (version-specific)
  • tinker - Execute PHP in Laravel context
  • list-routes - List all application routes
  • last-error - Get last error details

Chrome DevTools MCP

Section titled “Chrome DevTools MCP”

Purpose: Browser automation and debugging for testing frontend, checking console errors, inspecting network requests.

How it runs: Configured in .mcp.json as a stdio server running npx chrome-devtools-mcp@latest.

Use Cases:

  • Login flow testing
  • Console error detection
  • Network request inspection
  • Form interaction testing
  • Visual regression testing

Key Tools:

  • navigate_page - Navigate to URLs
  • take_snapshot - Capture page accessibility snapshot
  • fill_form - Fill form fields
  • click - Click elements
  • list_console_messages - Get console logs
  • list_network_requests - Inspect network traffic

Nightwatch MCP

Section titled “Nightwatch MCP”

Purpose: Query Laravel Nightwatch production monitoring data.

How it runs: Configured in .mcp.json as an HTTP server pointing to https://nightwatch.laravel.com/mcp.

Local Analytics MCP

Section titled “Local Analytics MCP”

The repository also contains analytics-mcp/ (the volare-analytics-mcp Google Analytics MCP server). It is not registered in .mcp.json - it is an optional local project you can run and register yourself if needed.

Verification

Section titled “Verification”

The project’s .claude/settings.json includes MCP permissions:

{
  "permissions": {
    "allow": [
      "mcp__laravel-boost",
      "mcp__chrome-devtools"
    ]
  },
  "enableAllProjectMcpServers": true
}

Troubleshooting

Section titled “Troubleshooting”

MCP Not Found:

  1. Ensure you launched Claude Code from the project root (where .mcp.json lives)
  2. Restart Claude Code
  3. Verify in Claude’s MCP settings

Laravel Boost Issues:

  • Check .env file exists in backend/
  • Verify Sail is running (cd backend && ./vendor/bin/sail ps). The SessionStart hook runs scripts/setup_env.sh to prepare the environment on startup.

Chrome DevTools Issues:

  • Ensure Chrome browser is installed
  • Check no firewall blocking local connections

Support

Section titled “Support”