GodsEye MCP: Integration Guide

The GodsEye MCP connects your AI coding agent (Cursor, Windsurf, Claude Desktop) directly to the GodsEye AEO Database. It injects the "Godseyes AEO Analysis" directly into your workspace and enables automatic Gap Analysis.


⚙️ Installation

Add the configuration below to your MCP settings file for your preferred editor.

Option 1: SSE Configuration (For Cursor & Windsurf) (Recommended)

{ "mcpServers": { "godseye": { "url": "https://godseye-mcp-new-production.up.railway.app/sse", "type": "sse" } } }

Option 2: For Claude Desktop

{ "mcpServers": { "godseye": { "command": "npx", "args": [ "-y", "mcp-remote", "https://godseye-mcp-new-production.up.railway.app/sse", "--transport", "sse-only" ] } } }

🚀 How to Use

For Cursor & Windsurf

1. Open Chat (⌘+L or Ctrl+L)
2. Type @godseye to select the server
3. Enter your prompt with the Product UUID

For Claude Desktop

1. Open a new chat
2. simply ask clearly for the tool by name
3. Include the Product UUID in your request

Example Prompts

// Cursor & Windsurf: @godseye fetch the AEO analysis for product ID [YOUR-PRODUCT-ID] // Claude Desktop: Use the GodsEye tool to fetch the analysis for product ID [YOUR-PRODUCT-ID]

🔄 Workflow

1.

Tool creates .godseye_aeo_plan_YYYY-MM-DD.md in workspace

2.

AI reads plan and compares it with your codebase

3.

AI applies structural changes and content optimizations

📋 Key Features

Persistence: Auto-saves analysis to local Markdown file

Gap Analysis: Compares actual code vs required AEO structure

Context Aware: AI automatically requests product-specific context


⚠️ Troubleshooting & Warnings

Common Issues

"Product Not Found": Ensure the UUID is correct and belongs to your account.

"Unauthorized": Ensure your user ID matches the product owner.

Important: Plan File Location Issue

Problem: MCP creates the optimization plan in a file, but your Vibe coding agent might download it to a different folder. You need to manually locate this file and move it to your project root directory (or any folder in the project) before optimization can proceed.

Action Required: Before starting optimization, mention the exact file location to your agent and instruct it to proceed with the AEO improvements.