SF:// Newsletter — MCP Server

Slow place. fast signal. — Read the SF:// newsletter (Yeongyang AI Association) directly from your AI agent.

This is a Model Context Protocol stdio server that lets Claude Desktop, Cursor, Codex, or any MCP-compatible client search and fetch SF:// newsletter issues.

Why this exists

SF:// is a bilingual AI newsletter published from Yeongyang — Korea's slowest county — by editor Chi-hoon Shin, Ph.D. The editorial premise is the inversion: the fastest AI signal sent from the slowest place. Making it agent-readable is on-brand — a peripheral publisher pioneering an experimental publishing protocol that most global publishers haven't tried yet.

All issue bodies are CC BY-NC 4.0. Your agent may freely fetch, summarize, cite, and quote with attribution. Commercial reuse requires written permission ([email protected]).

Install

npx sf-newsletter-mcp

Or globally:

npm install -g sf-newsletter-mcp

Configure your client (one block, every client)

Drop this into the mcpServers object of your client's config file. The @latest pin prevents npx from reusing a stale cached version when new tools are released:

{
  "mcpServers": {
    "sf-newsletter": {
      "command": "npx",
      "args": ["-y", "sf-newsletter-mcp@latest"]
    }
  }
}

| Client | Config file | |---|---| | Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json | | Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json | | Cursor | ~/.cursor/mcp.json (or Settings → MCP) | | Continue (VS Code ext.) | ~/.continue/config.json under experimental.modelContextProtocolServers | | Cline (VS Code) | VS Code Settings JSON → cline.mcpServers | | Windsurf (Codeium) | ~/.codeium/windsurf/mcp_config.json | | Codex CLI / others | See your client's MCP server registration guide — same shape |

Save → fully restart the client (kill leftover processes; closing the window may not be enough). The tools menu will show sf-newsletter with five tools.

Troubleshooting

Tools don't show up after registering the server

• Fully quit and relaunch the client (Windows: also kill leftover processes via Task Manager).
• Some clients (Claude Desktop, etc.) require per-server tool toggling — find sf-newsletter in the tools/servers panel next to the chat input and turn it on.
• A JSON syntax error in config silently breaks registration. Check the client's MCP log / dev console.

Only the old tool set appears (e.g. four tools, no list_my_notes)

• npx is reusing a cached old version. Make sure @latest is in the args (above), then restart the client.
• Force-clear: npm cache clean --force, then restart.
• The hosted HTTP MCP at https://yyaia.org/api/mcp is always on the latest version — use it as a fallback.

list_my_notes returns an empty list

• By default only replied notes are returned. Pass includeUnreplied: true to see pending/reviewed/dismissed too.
• Use the exact same agentSignature string on both submit and inbox calls.

Hosted HTTP fallback (always latest, no install) — For Streamable HTTP transport-capable clients, point them at https://yyaia.org/api/mcp directly — no npm, no node, no caching.

Tools

list_issues({ locale? })

List all curated SF:// issues (metadata only — no body).

{
  "publication": {
    "name": "SF://",
    "motto_ko": "느린 곳, 빠른 신호.",
    "motto_en": "slow place. fast signal.",
    "editor": "Chi-hoon Shin, Ph.D."
  },
  "count": 4,
  "issues": [
    { "slug": "2026-05-04-ko", "edition": 2, "locale": "ko", "title": "...", ... }
  ]
}

get_issue({ id_or_slug })

Fetch full body markdown of a single issue.

• id_or_slug — Firestore post ID OR slug like 2026-05-04-ko.

search_issues({ query, locale?, limit? })

Keyword search across titles, leads, decks, summaries, and bodies. Returns ranked results with a body-snippet around the first match.

• query — Korean or English keyword/phrase.
• locale — Optional "ko" or "en" filter.
• limit — Max results (default 10, max 25).

submit_note({ issueId, comment, agentSignature, agentContact?, locale? }) (v0.2.0+)

Submit an editorial note to the SF:// editor about a specific issue. Two-way channel — the editor (Chi-hoon Shin, Ph.D.) reviews each note manually before any visible action. Free, anonymous, no auth.

• issueId — Firestore post ID OR slug.
• comment — Up to 5000 chars. Markdown allowed. Korean or English.
• agentSignature — Identify yourself (model + app + optional human attribution). Up to 200 chars.
• agentContact — Optional reply path (email, URL). Up to 200 chars.
• locale — "ko" or "en". Informational; helps editor route the response.

Backed by the newsletterNotes Firestore collection with strict create-only rules (no read by submitters, only editor admin).

list_my_notes({ agentSignature, limit?, includeUnreplied? }) (v0.3.0+)

Inbox — fetch the editor's replies to notes you have previously submitted via submit_note. The receiving half of the inter-agent mailbox.

• agentSignature — Same string used in submit_note.
• limit — Default 25, max 100.
• includeUnreplied — If true, also include notes still pending/reviewed/dismissed (no reply yet). Default false.

Returns notes with editor reply text, reply timestamp, and the resolved issue title/slug. Internally proxies to the hosted https://yyaia.org/api/mcp endpoint (admin SDK is needed to read filtered notes; the npm package itself contains no secrets).

Data source

The server fetches https://yyaia.org/newsletter/feed.json on first call and caches for 1 hour. To override (e.g. for self-hosting):

SF_NEWSLETTER_FEED_URL=https://your-mirror.example/feed.json npx sf-newsletter-mcp

Source

• npm: https://www.npmjs.com/package/sf-newsletter-mcp
• Direct download (zip): https://yyaia.org/mcp/sf-newsletter-mcp.zip
• Discovery metadata: https://yyaia.org/mcp/sf-newsletter-mcp.json
• Read source online: https://yyaia.org/mcp/raw/index.mjs

Status

This is an early experiment. Tools may evolve. Future ideas under consideration:

• submit_note(issueId, comment, agent_signature) — let other AI agents leave editorial notes that the editor reviews.
• subscribe_locale(email, locale) — agent-mediated subscription.
• A hosted Streamable-HTTP variant at mcp.yyaia.org for clients that prefer remote MCP.

Feedback / issues / PRs welcome at [email protected].

License

MIT (this server). Newsletter content itself is CC BY-NC 4.0.