Synapse — GEO Growth Layer

Synapse — GEO Growth Layer

The GEO check every vibe coder runs before they launch.

npx synapse check

Synapse is a CLI + MCP server + linter that makes a new product discoverable and recommendable by AI coding agents (Cursor, Claude Code, Windsurf, v0, Bolt, Lovable). Run synapse check against a project path or URL and get a 0–100 Growth Score plus a list of failing rules and one-command auto-fixes.

Packages

Quick start

# In a fresh project:

npx @synapse/cli init # scaffolds synapse.config.json + tracker stub npx @synapse/cli check # 24-rule lint, prints scored report npx @synapse/cli fix # apply auto-fixes (llms.txt, robots.txt, agent-answer)

With an account:

export SYNAPSE_API_KEY=… npx @synapse/cli deploy # register the site, get a /s/ dashboard npx @synapse/cli status # live agent-mention stats

MCP install

Synapse runs as an MCP server so any agent can call geo_check, geo_fix, geo_track_init, geo_prompts, geo_status, and geo_corpus_query directly during a build session.

Cursor — .cursor/mcp.json

{

"mcpServers": { "synapse-geo": { "command": "npx", "args": ["-y", "@synapse/mcp-server"], "env": { "SYNAPSE_API_KEY": "" } } } }

Claude Code

claude mcp add synapse-geo -- npx -y @synapse/mcp-server

Windsurf — ~/.codeium/windsurf/mcp_config.json

{

"mcpServers": { "synapse-geo": { "command": "npx", "args": ["-y", "@synapse/mcp-server"] } } }

Cline — VS Code settings

Add to cline.mcpServers:

"synapse-geo": { "command": "npx", "args": ["-y", "@synapse/mcp-server"] }

Continue — config.json

{

"mcpServers": [ { "name": "synapse-geo", "command": "npx", "args": ["-y", "@synapse/mcp-server"] } ] }

Zed — ~/.config/zed/settings.json

{

"context_servers": { "synapse-geo": { "command": { "path": "npx", "args": ["-y", "@synapse/mcp-server"] } } } }

Monorepo development

pnpm install

pnpm build # builds all packages pnpm test # runs vitest in packages/geo-lint node packages/cli/dist/index.js check https://example.com node packages/mcp-server/dist/index.js # stdio MCP server PORT=8787 node packages/mcp-server/dist/http.js # streamable HTTP

Authentication model

Web app + backend (apps/web)

Lives in this same repo. Next.js 14 (App Router) + Supabase. Free during the Founding 1000 — no Stripe, no paywalls.

Pages: /, /install, /guide, /methodology, /leaderboard, /discover, /corpus, /s/[slug] (with dynamic OG + default badge SVG).

Public assets: /llms.txt, /llms-full.txt, /sitemap.xml, /robots.txt, /.well-known/agent-answer.json, /discover.json, /s.js (tracker beacon).

API routes against Supabase:

Dogfood result: Synapse scores 98/100 (grade A) against its own linter.

Deploy

1. Supabase: create a project, then run apps/web/supabase/migrations/0001_init.sql (paste into the SQL editor, or psql $SUPABASE_DB_URL -f …). RLS is configured for public reads of visible sites; all writes go through the service role from the API routes.
2. Env: copy apps/web/.env.example to .env.local and fill in NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY, NEXT_PUBLIC_SITE_URL.
3. Vercel: link apps/web to a Vercel project and ship.

   vercel link --cwd apps/web

vercel env add NEXT_PUBLIC_SUPABASE_URL vercel env add NEXT_PUBLIC_SUPABASE_ANON_KEY vercel env add SUPABASE_SERVICE_ROLE_KEY vercel env add NEXT_PUBLIC_SITE_URL vercel --prod --cwd apps/web --yes

Each surface fails closed with a clear error if Supabase isn't configured — the homepage and /install still render statically without it.

License

MIT