
Synapse — GEO Growth Layer
Synapse runs a 24-rule linter that scores how discoverable your project is to AI coding agents like Cursor, Windsurf, and Claude Code. The MCP server exposes six tools including geo_check for running audits, geo_fix for applying auto-fixes to llms.txt and robots.txt, and geo_status for live agent-mention analytics. You can call it during a build session to check your GEO score (0-100), get a report of failing rules, and patch missing files without leaving your editor. It works read-only by default and gates write operations behind SYNAPSE_API_KEY. The same codebase also ships a CLI (npx synapse check) and a web dashboard at runsynapse.dev where you can register sites and track agent traffic.
- tools
- 6
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 2
- last updated
- May 14, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
geo_checkRun the 24-rule Synapse GEO linter against a URL or a local project path and return a scored report. Use this BEFORE shipping a new product.2 params
Run the 24-rule Synapse GEO linter against a URL or a local project path and return a scored report. Use this BEFORE shipping a new product.
fail_onstringcritical · high · medium · low · nevertargetstringgeo_fixApply Synapse's auto-fixers to a local project — writes static files (llms.txt, robots.txt, agent-answer.json, etc.). Requires write access to the path.1 params
Apply Synapse's auto-fixers to a local project — writes static files (llms.txt, robots.txt, agent-answer.json, etc.). Requires write access to the path.
project_pathstringgeo_track_initRegister the project with the Synapse dashboard to begin tracking AI-agent referrals. Returns a slug and tracking ID.3 params
Register the project with the Synapse dashboard to begin tracking AI-agent referrals. Returns a slug and tracking ID.
namestringproject_pathstringurlstringgeo_promptsGenerate the prompt pack used to test whether AI engines surface this product.2 params
Generate the prompt pack used to test whether AI engines surface this product.
audiencestringcategorystringgeo_statusFetch the live Growth Score and agent-mention stats for an installed Synapse site.1 params
Fetch the live Growth Score and agent-mention stats for an installed Synapse site.
slugstringgeo_corpus_queryQuery the public Synapse corpus for products matching a given intent.2 params
Query the public Synapse corpus for products matching a given intent.
intentstringlimitnumberSponsors
Configuration
SYNAPSE_API_KEYsecretOptional. Required only for geo_fix and geo_track_init tools. Read-only tools work without a key.
SYNAPSE_BACKENDdefault: https://runsynapse.devOverride the Synapse backend URL. Defaults to https://runsynapse.dev.
Readme
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
| Package | Description |
|---|---|
@synapse/geo-lint | 24-rule GEO linter. Programmatic API: lint(target) → LintReport. |
@synapse/cli | CLI with init, check, fix, deploy, status. Installs as synapse. |
synapse | Thin meta-wrapper for the npx synapse UX. |
@synapse/mcp-server | MCP server exposing 6 tools, 3 resources, 3 prompts. Stdio + streamable HTTP. |
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)
Details
- Repository
- github.com/calvinling2021-star/synapse
- Website
- runsynapse.dev
- Package
@calvin8miles/mcp-server- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active