VisibleMax MCP

What it is

VisibleMax MCP is a stdio server that forwards tool calls to POST /api/mcp with a workspace Bearer token (vm_…). Your assistant lists tools, calls them with your consent, and returns structured JSON.

Quick install

1. Sign in and open Install MCP (or sign up).
2. Run the one-shot installer, then copy the client config (token is minted on copy).
3. Restart your assistant and paste a verify prompt below.

curl -fsSL https://YOUR_HOST/mcp/install.sh | VISIBLEMAX_INSTALL_BASE=https://YOUR_HOST bash

Clients

• Cursor / Windsurf / VS Code / Codex / Gemini CLI — stdio mcp.json with VISIBLEMAX_API_URL and VISIBLEMAX_API_TOKEN.
• Claude Code — claude mcp add visiblemax … (CLI shown in-app).
• ChatGPT — coming soon (remote OAuth).

Authentication

Tokens are created in Install MCP or Security. Only the SHA-256 hash is stored. Revoke anytime. Cap: 10 active tokens per workspace.

Core tools

• get_company_context — brand, score, buyer prompts
• start_scan / get_scan_status / get_visibility_report
• list_opportunities / get_opportunity / mark_opportunity_status
• list_priorities / get_weekly_plan
• get_fix_pack / get_asset / list_assets
• list_competitors / get_competitor_report
• list_buyer_prompts / get_prompt_results
• run_verification / get_verification
• get_attribution_summary — AI-attributed revenue

Example prompts

• “Using VisibleMax MCP, list my open AI visibility opportunities and the highest-impact fix first.”
• “Call get_company_context and summarize my score and top buyer prompts.”
• “Get the fix pack for the top opportunity and apply the files in this repo, then mark_opportunity_status done.”
• “Run verification for this project and tell me which prompts we won.”
• “Show get_attribution_summary — any AI-attributed signups or revenue?”

Hosted API

GET /api/mcp returns tool metadata. POST /api/mcp with body { "tool": "…", "arguments": { } } and Authorization: Bearer vm_…. See also the API overview.

Troubleshooting

• Confirm the token starts with vm_ and isn’t revoked.
• Set VISIBLEMAX_API_URL to your deployed origin (no trailing slash).
• Re-run the install script if ~/.visiblemax/mcp is missing dependencies.
• Prefer project_id when you have multiple projects.