MCP

For MCP transport/auth/resources and tools, see /common/mcp.html.

Scope: contract-only (no internal infra/storage/alarms). Canonical protocol lives at https://mcp.g3nretailstack.com/visualgrid/PROTOCOL.md and is mirrored here at /visualgrid/PROTOCOL.md. MCP server endpoint: https://api.mcp.g3nretailstack.com/mcp (CloudFront mcp.g3nretailstack.com/mcp 307-redirects there).

Quick checks (once published)

1. Protocol reachable: curl -I https://mcp.g3nretailstack.com/visualgrid/PROTOCOL.md → 200 text/markdown.
2. Initialize MCP:

PROTOCOL=2025-03-26
curl -i -X POST https://api.mcp.g3nretailstack.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":"init","method":"initialize","params":{"protocolVersion":"'"$PROTOCOL"'","clientInfo":{"name":"manual","version":"0.0.1"},"capabilities":{"resources":{},"logging":{}}}}'
# capture MCP-Session-Id header for follow-up requests

3. With session headers, call resources/list then resources/read for https://mcp.g3nretailstack.com/visualgrid/PROTOCOL.md.

Contents summary

• Contract surfaces for VisualGrid (API Gateway base https://api.g3nretailstack.com/visualgrid).
• Real-time tree explorer for all 21 DynamoDB tables across the g3nretailstack ecosystem.
• Root-only auth (scrypt secret code verification, 1h TTL tokens). No session, no org scoping.
• Response envelope + error tags (see Common contract).

Service notes

• OpenAPI: https://doc.g3nretailstack.com/visualgrid/openapi.yaml
• Base path: /visualgrid on https://api.g3nretailstack.com.
• Direct Lambdas: none (API Gateway only).
• Protocol: see PROTOCOL.md for full endpoint inventory and auth details.