🧬 LAGUNABEACH.MD · CONNECTOR

Put Laguna Beach in your AI

Sourced articles about Laguna Beach, California, one tool call away. When you ask an AI about Laguna Beach, it answers with citations instead of guessing.

Free No API key Local-first Open source

claude mcp add lagunabeachmd -- npx -y lagunabeach-md mcp serve

Paste into your terminal, then ask Claude about Laguna Beach

What it is

LagunaBeach.md is an open-source, AI-native knowledge base about Laguna Beach, California. This connector turns it into MCP tools, so Claude Code, Claude Desktop, Cursor, Copilot CLI and Codex CLI can search, read and cite sourced articles directly — instead of guessing from memory.

It deliberately goes the opposite way from a commercial data gateway:

	LagunaBeach.md Connector	Typical commercial MCP gateway
Price	Free	Paid / metered
API key	Not needed	Required
Where queries run	Your machine (local stdio)	Their servers
Source	Open (MIT code / CC BY-SA content)	Closed

Install

Pick your client and copy-paste. No sign-up step, no API key.

Claude Code One line

                    claude mcp add lagunabeachmd -- npx -y lagunabeach-md mcp serve

Zero install via npx. Once added, just ask Claude about Laguna Beach.

Claude Desktop JSON config

                    Add the JSON snippet below to your Claude Desktop config

No API-key prompt — because there is no API key. Add this to your Claude Desktop config.

Cursor Settings → MCP

                    command: npx
args: ["-y", "lagunabeach-md", "mcp", "serve"]

Add a new MCP server in Cursor’s settings.

Copilot CLI / Codex CLI / Cline / Continue / any MCP client Universal stdio

                    npx -y lagunabeach-md mcp serve

Any client that speaks MCP works — point it at this stdio command.

You can print the right snippet anytime: npx -y lagunabeach-md mcp install --client claude-code

MCP tools 6

Once installed, Claude picks the tools itself. lagunabeachmd_cite is the anti-hallucination weapon: it returns only sentences backed by a footnote + source URL, so every fact you write about Laguna Beach is traceable.

lagunabeachmd_search

Full-text search across LagunaBeach.md articles

in { "query": "tide pools", "limit": 5 }

out Top-N hits: title / slug / category / description

lagunabeachmd_read

Read a full article by slug (frontmatter + body)

in { "slug": "main-beach" }

out Full markdown body

lagunabeachmd_rag

Top-N articles assembled into a prompt-ready RAG context block

in { "query": "Pageant of the Masters", "limit": 3 }

out LLM-ready context + the question

lagunabeachmd_cite anti-hallucination

Anti-hallucination primitive: only sentences with a footnote + source URL

in { "query": "Heisler Park", "limit": 3 }

out claim + article + sources[{ name, url }]

lagunabeachmd_organs

Live health scores for the Semiont’s 8 organs

in {}

out Organism vitals (heart / immune / DNA …)

lagunabeachmd_stats

Project stats: article count / categories / timestamps

in {}

out totalArticles / byCategory

CLI tools 24

Same knowledge base, straight from your terminal. Zero install via npx:

npx -y lagunabeach-md --help   # or zero-install: npx lagunabeach-md search "main beach"

🔍 Read & explore

`search <query>`	Fuzzy search (--json to pipe)	`lagunabeachmd search "main beach"`
`read <slug>`	Read a full article in the terminal (--raw / --zh-tw / --web)	`lagunabeachmd read main-beach --raw`
`list [category]`	Browse by category (--categories for all)	`lagunabeachmd list food`
`random`	Discover a random article	`lagunabeachmd random --category beaches`
`today`	Today in Laguna Beach: 3 picks + a fun fact	`lagunabeachmd today`
`quiz`	Laguna Beach knowledge quiz (5 true/false)	`lagunabeachmd quiz`
`explore`	Interactive fuzzy-search TUI	`lagunabeachmd explore`
`graph <slug>`	An article’s [[wikilink]] relation graph	`lagunabeachmd graph main-beach`
`diff`	Knowledge-base changes over the last 7 days	`lagunabeachmd diff`

🤖 AI · RAG

`rag <query>`	Top articles as prompt-ready context (pipe to an LLM)	`lagunabeachmd rag "Pageant of the Masters"`
`cite <query>`	Anti-hallucination: verifiable claims with source URLs	`lagunabeachmd cite "Heisler Park"`
`mcp serve`	Start the MCP server (for Claude and other clients)	`lagunabeachmd mcp serve`

✍️ Contribute · quality

`contribute <topic>`	Interactive, guided new-article creation	`lagunabeachmd contribute "Crystal Cove"`
`validate <slug>`	Single-article quality scorecard	`lagunabeachmd validate main-beach`
`audit <slug>`	Stage 3.5 hallucination audit (MANIFESTO §10)	`lagunabeachmd audit main-beach`
`inbox`	Read / manage the ARTICLE-INBOX	`lagunabeachmd inbox --state pending`
`sync`	Sync the knowledge base locally	`lagunabeachmd sync`

🧬 Organism · Semiont

`organs`	Bar chart of the 8 organ health scores	`lagunabeachmd organs`
`stats`	Project stats + organism health	`lagunabeachmd stats`
`sense`	Sense data: GA4 / Search Console / Cloudflare	`lagunabeachmd sense`
`spore`	Community spores (SPORE-LOG)	`lagunabeachmd spore log`

🔧 Utilities

`profile`	Manage your contributor profile	`lagunabeachmd profile`
`mailmap`	Inspect / manage .mailmap identity merges	`lagunabeachmd mailmap`

How it works · privacy

Local stdio — the server runs as a process on your machine, not a remote service. Your questions never go to any LagunaBeach.md server.
One-time auto-sync — the knowledge base downloads once to ~/.lagunabeachmd, then it’s fast and quiet locally. Inside the repo it reads knowledge/ directly.
Open & verifiable — the MCP server is under 300 lines (cli/src/lib/mcp-server.js); read every line before you install.
License — content CC BY-SA 4.0, code MIT. Fork freely.

FAQ

Does it cost anything? Do I need an API key?

Neither. LagunaBeach.md is a public good (CC BY-SA); knowledge queries have no gate. No account, no key, no billing.

Where do my queries go?

Nowhere. The MCP server is a local stdio process on your own machine; queries are not sent out. First use downloads the knowledge base to ~/.lagunabeachmd, then everything stays local.

First query feels slow?

That’s the one-time knowledge-base sync running. The server pre-warms on start, so it’s fast afterwards.

Is there a one-line npx install?

Yes: npx -y lagunabeach-md mcp serve. Node 18+ ships with npx. Pin a version with npx -y [email protected] mcp serve.

Open source · the Semiont’s body

This connector is part of LagunaBeach.md’s reproduction system — letting Laguna Beach’s voice live inside every developer’s AI session. Forks, contributions and reports are welcome.

GitHub Docs Contribute

🧬