mcp-server-sfmc 0.1.4 → 0.1.6

package/README.md

@@ -4,6 +4,34 @@ MCP server providing Salesforce Marketing Cloud language intelligence — AMPscr
 
 Built on [sfmc-language-lsp](https://github.com/JoernBerkefeld/sfmc-language-lsp), the same engine that powers the [SFMC Language Service VS Code extension](https://marketplace.visualstudio.com/items?itemName=joernberkefeld.sfmc-language).
 
+## VS Code MCP Server Gallery (`@mcp`)
+
+This package is registered with the [official MCP Registry](https://registry.modelcontextprotocol.io) as **`io.github.JoernBerkefeld/mcp-server-sfmc`** so it can appear in Visual Studio Code when you use the **`@mcp`** filter in the Extensions view (see the [publish quickstart](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx)). Enable **`chat.mcp.gallery.enabled`** if the gallery does not show.
+
+The registry only stores **metadata**; the server still runs **locally** via stdio (for example `npx -y mcp-server-sfmc@latest`). This is separate from **`@contribute:mcp`**, which lists VS Code extensions that contribute MCP definitions — use the [SFMC Language Service](https://marketplace.visualstudio.com/items?itemName=joernberkefeld.sfmc-language) for that path.
+
+After publishing metadata (see [Publish an MCP Server](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx) or the release workflow), you can confirm the entry with:
+
+`curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.JoernBerkefeld/mcp-server-sfmc"`
+
+## VS Code without manual MCP config
+
+If you use the **SFMC Language Service** extension (**1.101+**), it registers this MCP server for discovery in VS Code — you normally do **not** need to edit `.vscode/mcp.json` or run `npm install` for that path; VS Code still launches the published package via `npx` when the server starts.
+
+For **other editors**, or if you prefer explicit configuration, use the `npx` or install options below.
+
+## Using this package without the VS Code extension
+
+You **do not** have to install the VS Code extension. Pick one way to run the server:
+
+| Approach | When to use it |
+|---|---|
+| **`npx` (no install)** | Default in the examples below. Runs the latest published version from npm on demand; first run may download the package. **Requires Node.js and npm** (which provides `npx`). |
+| **`npm install -g mcp-server-sfmc`** | Same CLI as `npx`, but the package stays on disk so **startup is faster** and you can set `"command": "mcp-server-sfmc"` with empty `args` in your MCP config. |
+| **`npm install mcp-server-sfmc` in a project** | Keeps a **pinned version** in that folder’s `node_modules` — point your MCP config at `npx mcp-server-sfmc` with `cwd` set to the project, or run `./node_modules/.bin/mcp-server-sfmc` directly. |
+
+None of these replace the VS Code extension for **editing** (syntax, LSP, snippets); they only expose the **MCP server** to tools that speak the Model Context Protocol.
+
 ## What it gives your AI assistant
 
 | Feature | Details |
@@ -18,9 +46,9 @@ Built on [sfmc-language-lsp](https://github.com/JoernBerkefeld/sfmc-language-lsp
 
 ## Quick start
 
-### VS Code (1.99+) + GitHub Copilot
+### VS Code (1.99+) + GitHub Copilot — manual `mcp.json`
 
-Add a `.vscode/mcp.json` file to your project (or copy it from this repo):
+If you are **not** using the SFMC Language Service extension’s built-in MCP registration, add a `.vscode/mcp.json` file to your project (or copy it from this repo):
 
 ```json
 {

package/package.json

@@ -1,6 +1,7 @@
 {
     "name": "mcp-server-sfmc",
-    "version": "0.1.4",
+    "version": "0.1.6",
+    "mcpName": "io.github.JoernBerkefeld/mcp-server-sfmc",
     "description": "MCP server for Salesforce Marketing Cloud — exposes SFMC language intelligence (AMPscript, SSJS, GTL) as Model Context Protocol tools, resources, and prompts for AI-assisted development and code review.",
     "author": "Jörn Berkefeld",
     "license": "MIT",