feat: add DataForSEO and Serper MCP integrations with OpenCode CLI testing support

- Add DataForSEO MCP subagent for comprehensive SEO data APIs
- Add Serper MCP subagent for Google Search API
- Add MCP config templates for both services
- Update setup.sh to configure SEO MCP servers
- Add OpenCode CLI testing section to documentation
- Create opencode-test-helper.sh for testing config changes
- Update generate-opencode-agents.sh with new MCP configurations
- Update AGENTS.md and troubleshooting.md with CLI testing guidance

Author: marcusquinn

.agent/AGENTS.md

@@ -45,7 +45,7 @@
 | `build-mcp/` | MCP development (api-wrapper, deployment, server-patterns, transports) |
 | `memory/` | Cross-session memory patterns |
 | `wordpress/` | WordPress subagents (wp-dev, wp-admin, localwp, mainwp, wp-preferred) |
-| `seo/` | SEO subagents (google-search-console) |
+| `seo/` | SEO subagents (google-search-console, dataforseo, serper) |
 | `content/` | Content subagents (guidelines) |
 | `tools/ai-assistants/` | AI tools (agno, capsolver, windsurf, configuration) |
 | `tools/browser/` | Browser automation (playwright, stagehand, stagehand-python, chrome-devtools, crawl4ai, pagespeed) |
@@ -55,6 +55,7 @@
 | `tools/data-extraction/` | Data extraction (outscraper) |
 | `tools/deployment/` | Deployment tools (coolify, coolify-cli, coolify-setup, vercel) |
 | `tools/git/` | Git platforms (github-cli, gitlab-cli, gitea-cli, github-actions, authentication, security) |
+| `tools/credentials/` | Credential management (list-keys, api-key-management, api-key-setup, vaultwarden) |
 | `tools/opencode/` | OpenCode configuration and paths |
 | `services/hosting/` | Hosting providers (hostinger, hetzner, cloudflare, cloudron, closte, 101domains, spaceship, localhost, dns-providers, domain-purchasing) |
 | `services/email/` | Email services (ses) |
@@ -88,6 +89,7 @@ Read subagents only when task requires them. The AI-CONTEXT section above contai
 - Release/versioning → `workflows/`
 - Browser automation → `tools/browser/`
 - MCP development → `build-mcp/`
+- SEO analysis → `seo/` (google-search-console, dataforseo, serper)
 
 ## Security
 
@@ -111,6 +113,7 @@ Never create files in `~/` root for files needed only with the current task.
 
 | Script | Purpose |
 |--------|---------|
+| `list-keys-helper.sh` | List all API keys with their storage locations |
 | `linters-local.sh` | Run local linting (ShellCheck, secretlint, patterns) |
 | `code-audit-helper.sh` | Run remote auditing (CodeRabbit, Codacy, SonarCloud) |
 | `version-manager.sh` | Version bumps and releases |
@@ -123,6 +126,7 @@ Never create files in `~/` root for files needed only with the current task.
 | `sonarcloud-cli.sh` | SonarCloud analysis |
 | `codacy-cli.sh` | Codacy code quality |
 | `secretlint-helper.sh` | Secret detection |
+| `opencode-test-helper.sh` | Test OpenCode config changes via CLI |
 
 ## Quality Workflow
 

.agent/aidevops/troubleshooting.md

@@ -218,6 +218,39 @@ echo $CLOUDFLARE_ACCOUNT_ID
 echo $CLOUDFLARE_API_TOKEN
 ```
 
+### **5. Test Configuration Changes with CLI**
+
+The OpenCode TUI requires restart to pick up `opencode.json` changes. Use CLI for quick testing:
+
+```bash
+# Test new MCP configuration
+opencode run "List available tools from dataforseo_*" --agent SEO
+
+# Debug MCP connection (shows errors in terminal)
+opencode run "Call serper_google_search with query 'test'" --agent SEO 2>&1
+
+# Verify agent has correct tool access
+opencode run "What MCP tools can you access?" --agent SEO
+
+# Test slash commands
+opencode run "/new-command arg1" --agent Build+
+```
+
+**Workflow for adding new MCPs:**
+
+1. Edit `~/.config/opencode/opencode.json`
+2. Test with CLI: `opencode run "Test [mcp]" --agent [agent] 2>&1`
+3. If working, restart TUI to use interactively
+4. If failing, check stderr output and iterate on config
+5. Update `generate-opencode-agents.sh` to persist changes
+
+**Helper script for common tests:**
+
+```bash
+~/.aidevops/agents/scripts/opencode-test-helper.sh test-mcp dataforseo SEO
+~/.aidevops/agents/scripts/opencode-test-helper.sh test-agent Plan+
+```
+
 ## Performance Optimization
 
 ### **Chrome DevTools Optimization**

.agent/scripts/context-builder-helper.sh

@@ -20,10 +20,10 @@
 set -euo pipefail
 
 # Configuration
-# shellcheck disable=SC2034
 declare SCRIPT_DIR
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
 readonly SCRIPT_DIR
+export SCRIPT_DIR  # Available for sourced scripts
 declare SCRIPT_NAME
 SCRIPT_NAME="$(basename "$0")"
 readonly SCRIPT_NAME

.agent/scripts/generate-opencode-agents.sh

@@ -63,6 +63,7 @@ echo -e "${BLUE}Configuring primary agents in opencode.json...${NC}"
 # Check if opencode.json exists
 if [[ ! -f "$OPENCODE_CONFIG" ]]; then
     echo -e "${YELLOW}Warning: $OPENCODE_CONFIG not found. Creating minimal config.${NC}"
+    # shellcheck disable=SC2016
     echo '{"$schema": "https://opencode.ai/config.json"}' > "$OPENCODE_CONFIG"
 fi
 
@@ -318,6 +319,8 @@ primary_agents = {
             "webfetch": True,
             "gsc_*": True,
             "ahrefs_*": True,
+            "dataforseo_*": True,
+            "serper_*": True,
             "augment-context-engine_*": True
         }
     },
@@ -370,6 +373,32 @@ if 'outscraper_*' not in config['tools']:
     config['tools']['outscraper_*'] = False
     print("  Added outscraper_* to tools (disabled globally, enabled for @outscraper subagent)")
 
+# DataForSEO MCP - for comprehensive SEO data
+if 'dataforseo' not in config['mcp']:
+    config['mcp']['dataforseo'] = {
+        "type": "local",
+        "command": ["/bin/bash", "-c", "source ~/.config/aidevops/mcp-env.sh && DATAFORSEO_USERNAME=$DATAFORSEO_USERNAME DATAFORSEO_PASSWORD=$DATAFORSEO_PASSWORD /opt/homebrew/bin/npx dataforseo-mcp-server"],
+        "enabled": True
+    }
+    print("  Added dataforseo MCP server")
+
+if 'dataforseo_*' not in config['tools']:
+    config['tools']['dataforseo_*'] = False
+    print("  Added dataforseo_* to tools (disabled globally, enabled for SEO agent)")
+
+# Serper MCP - for Google Search API
+if 'serper' not in config['mcp']:
+    config['mcp']['serper'] = {
+        "type": "local",
+        "command": ["/bin/bash", "-c", "source ~/.config/aidevops/mcp-env.sh && SERPER_API_KEY=$SERPER_API_KEY /opt/homebrew/bin/serper-mcp-server"],
+        "enabled": True
+    }
+    print("  Added serper MCP server")
+
+if 'serper_*' not in config['tools']:
+    config['tools']['serper_*'] = False
+    print("  Added serper_* to tools (disabled globally, enabled for SEO agent)")
+
 with open(config_path, 'w') as f:
     json.dump(config, f, indent=2)
 
@@ -395,7 +424,7 @@ while IFS= read -r f; do
     name=$(basename "$f" .md)
     [[ "$name" == "AGENTS" || "$name" == "README" ]] && continue
 
-    rel_path="${f#$AGENTS_DIR/}"
+    rel_path="${f#"$AGENTS_DIR"/}"
 
     # Determine additional tools based on subagent name/path
     extra_tools=""
@@ -412,6 +441,12 @@ while IFS= read -r f; do
         google-search-console)
             extra_tools=$'  gsc_*: true'
             ;;
+        dataforseo)
+            extra_tools=$'  dataforseo_*: true\n  webfetch: true'
+            ;;
+        serper)
+            extra_tools=$'  serper_*: true\n  webfetch: true'
+            ;;
         *)
             ;;  # No extra tools for other agents
     esac

.agent/scripts/generate-opencode-commands.sh

@@ -15,13 +15,11 @@
 
 set -euo pipefail
 
-AGENTS_DIR="$HOME/.aidevops/agents"
 OPENCODE_COMMAND_DIR="$HOME/.config/opencode/command"
 
 # Colors
 GREEN='\033[0;32m'
 BLUE='\033[0;34m'
-YELLOW='\033[1;33m'
 NC='\033[0m'
 
 echo -e "${BLUE}Generating OpenCode commands...${NC}"
@@ -326,6 +324,48 @@ EOF
 ((command_count++))
 echo -e "  ${GREEN}✓${NC} Created /hotfix command"
 
+# =============================================================================
+# LIST-KEYS COMMAND
+# =============================================================================
+# List all API keys available in session
+
+cat > "$OPENCODE_COMMAND_DIR/list-keys.md" << 'EOF'
+---
+description: List all API keys available in session with their storage locations
+agent: Build+
+---
+
+Run the list-keys helper script and format the output as a markdown table:
+
+!`~/.aidevops/agents/scripts/list-keys-helper.sh --json $ARGUMENTS`
+
+Parse the JSON output and present as markdown tables grouped by source.
+
+Format with padded columns for readability:
+
+```
+### ~/.config/aidevops/mcp-env.sh
+
+| Key                        | Status        |
+|----------------------------|---------------|
+| OPENAI_API_KEY             | ✓ loaded      |
+| ANTHROPIC_API_KEY          | ✓ loaded      |
+| TEST_KEY                   | ⚠ placeholder |
+```
+
+Status icons:
+- ✓ loaded
+- ⚠ placeholder (needs real value)  
+- ✗ not loaded
+- ℹ configured
+
+Pad key names to align columns. End with total count.
+
+Security: Key values are NEVER displayed.
+EOF
+((command_count++))
+echo -e "  ${GREEN}✓${NC} Created /list-keys command"
+
 # =============================================================================
 # CONTEXT BUILDER COMMAND
 # =============================================================================
@@ -403,6 +443,7 @@ echo "  /feature          - Create feature branch"
 echo "  /bugfix           - Create bugfix branch"
 echo "  /hotfix           - Create hotfix branch"
 echo "  /context          - Build AI context"
+echo "  /list-keys        - List API keys with storage locations"
 echo ""
 echo "Quality workflow: /linters-local -> /code-audit-remote -> /pr"
 echo ""