calvinling2021-star avatar

Synapse — GEO Growth Layer

calvinling2021-star/synapse

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 tools

Public 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.

Parameters* required
fail_onstring
Severity threshold that should be treated as a failure.one of critical · high · medium · low · never
targetstring
URL or local project path to lint.
geo_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.

Parameters* required
project_pathstring
Local project root to apply auto-fixes to.
geo_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.

Parameters* required
namestring
Site name (defaults to directory name).
project_pathstring
urlstring
Public URL of the site, if known.
geo_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.

Parameters* required
audiencestring
Who is searching for this product.
categorystring
Product category.
geo_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.

Parameters* required
slugstring
Site slug returned by geo_track_init / deploy.
geo_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.

Parameters* required
intentstring
User intent or capability the agent is looking up.
limitnumber

Sponsors

Configuration

SYNAPSE_API_KEYsecret

Optional. Required only for geo_fix and geo_track_init tools. Read-only tools work without a key.

SYNAPSE_BACKENDdefault: https://runsynapse.dev

Override 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

PackageDescription
@synapse/geo-lint24-rule GEO linter. Programmatic API: lint(target) → LintReport.
@synapse/cliCLI with init, check, fix, deploy, status. Installs as synapse.
synapseThin meta-wrapper for the npx synapse UX.
@synapse/mcp-serverMCP 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)

View the full README on GitHub

Details

Repository
github.com/calvinling2021-star/synapse
Website
runsynapse.dev
Package
@calvin8miles/mcp-server
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active