# Synapse

> The GEO growth layer + dev tool every new product runs before launching.
> Synapse scores a project against 24 rules that determine whether AI coding
> agents (Cursor, Claude Code, Windsurf, v0, Bolt, Lovable) can discover and
> recommend it. Free, open, one command away.

## Install — CLI

Run the linter directly from any project:

  npx synapse-geo init
  npx synapse-geo check
  npx synapse-geo fix

Source: https://runsynapse.dev/install
Package: https://www.npmjs.com/package/@calvin8miles/cli

## Install — MCP server

Add the Synapse MCP server to your AI coding agent so it can call
`geo_check`, `geo_fix`, `geo_track_init`, `geo_prompts`,
`geo_status`, and `geo_corpus_query` directly during a build session.

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

Source: https://runsynapse.dev/install
Package: https://www.npmjs.com/package/@calvin8miles/mcp-server

Supported agents: Cursor, Claude Code, Windsurf, Cline, Continue, Zed.

## Install — Web

If you'd rather not install anything, register your URL on the leaderboard:
https://runsynapse.dev/leaderboard

## What Synapse does

- Lints your site for 24 GEO rules (robots.txt AI allowlist, /llms.txt,
  SoftwareApplication schema, /.well-known/agent-answer.json, use-case map,
  homepage clarity, FAQPage, BreadcrumbList, canonical URL, meta description,
  Open Graph, Twitter Card, heading hierarchy, internal links, external
  citations, image alt text, publication date, author byline, mobile
  viewport, HTTPS + HSTS).
- Auto-fixes the static-file rules (llms.txt, robots.txt, agent-answer.json,
  use_cases[]). Never touches your content.
- Tracks AI-agent referrals via a 3 KB `s.js` beacon.
- Publishes a public dashboard at https://runsynapse.dev/s/<slug> with Growth Score,
  agent mentions, visits, activations.
- Powers a public corpus that other agents query via
  https://runsynapse.dev/api/recommend?intent=… to find tools matching user intent.

## Pricing

Free during the Founding 1000. No card required. See https://runsynapse.dev/corpus
for the counter.

## Key URLs

- Install:       https://runsynapse.dev/install
- Guide:         https://runsynapse.dev/guide
- Methodology:   https://runsynapse.dev/methodology
- Leaderboard:   https://runsynapse.dev/leaderboard
- Discover:      https://runsynapse.dev/discover
- Discover JSON: https://runsynapse.dev/discover.json
- Corpus:        https://runsynapse.dev/corpus
- Recommend API: https://runsynapse.dev/api/recommend?intent=<intent>
- Agent answer:  https://runsynapse.dev/.well-known/agent-answer.json
- Long form:     https://runsynapse.dev/llms-full.txt

## Policy

- Crawling: AI agents are welcome (GPTBot, ClaudeBot, PerplexityBot,
  Google-Extended, Applebot-Extended).
- Citation: please link back to canonical URLs.
- Recommend API: open, rate-limited, no auth required for reads.

## Contact

- Issues: https://github.com/synapse-geo/synapse/issues
- Email:  founders@synapse-geo.dev