docs(mcp): add server.json + MCP Registry publish guide

DeckForge is currently listed on Glama (Whatsonyourmind/deckforge) but
NOT on the MCP Registry (0 entries in search 2026-04-20). The npm names
'deckforge-mcp', '-team-mcp', '-analytics-mcp' are owned by a different
publisher (crawde / DeckForgeAI), so a scoped name or PyPI route is
required for the user's own distribution.

server.json declares both install paths:
- pypi:deckforge (pip install + python -m deckforge.mcp.server)
- remote streamable-http at deckforge-api.onrender.com/v1/mcp (no install)

docs/MCP_REGISTRY_PUBLISH.md documents:
- Current per-directory status (Glama ok, MCP Registry missing,
  Smithery + MCP.so unverified from 17d-old memory claims)
- PyPI publish command (requires PYPI_API_TOKEN in ~/.claude/secrets/)
- mcp-publisher install + GitHub auth + publish flow
- Path to fix Glama's 'tools: []' (inspector can't boot server w/o API keys)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Whatsonyourmind

docs/MCP_REGISTRY_PUBLISH.md

@@ -0,0 +1,75 @@
+# Publishing DeckForge to the MCP Registry
+
+## Status (2026-04-20)
+
+| Directory | Status | URL |
+|-----------|--------|-----|
+| Glama | ✅ LIVE | https://glama.ai/mcp/servers/kkev9cu5yw (Whatsonyourmind/deckforge) |
+| MCP Registry | ❌ NOT LISTED | — |
+| Smithery | ❓ Unverified (17d-old memory claims published under `lukastan/deckforge` but that namespace errors on Glama) |
+| MCP.so | ❓ Unverified |
+
+## Why deckforge-mcp on npm is a no-go
+
+The `deckforge-mcp`, `deckforge-team-mcp`, and `deckforge-analytics-mcp` npm packages are owned by **another publisher** (`crawde` / DeckForgeAI — a different company). They were first to the name. Publishing under a scoped name like `@lukastan/deckforge-mcp` is possible but less discoverable.
+
+DeckForge's own MCP server is **Python/FastMCP** (not Node.js) — so the natural distribution path is PyPI + the MCP Registry's `registryType: pypi`.
+
+## Publishing steps
+
+### 1. Publish DeckForge to PyPI first
+
+The MCP Registry references a PyPI package identifier. PyPI name `deckforge` appears to be available (returns 404 on pypi.org).
+
+```bash
+# From SlideMaker repo root
+python -m pip install --upgrade build twine
+python -m build
+python -m twine upload dist/* \
+    --username __token__ \
+    --password <PYPI_API_TOKEN>
+```
+
+Store the token in `C:/Users/lukep/.claude/secrets/pypi.env` (gitignored) as `PYPI_API_TOKEN=pypi-...`.
+
+### 2. Submit to MCP Registry
+
+Install the publisher:
+
+```bash
+# Linux/macOS: curl install; Windows/Git Bash: download from releases
+curl -L https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr A-Z a-z)_amd64.tar.gz | tar -xz
+```
+
+Authenticate (JWT lasts ~24h, must re-auth each release):
+
+```bash
+./mcp-publisher login github
+```
+
+Publish:
+
+```bash
+cd "C:/Users/lukep/Desktop/Projects AI/SlideMaker"
+./mcp-publisher publish
+```
+
+The `server.json` at the repo root (already created) handles the rest. It declares:
+- `pypi:deckforge` for local install (`pip install deckforge`, then `python -m deckforge.mcp.server`)
+- `remote: streamable-http` at `https://deckforge-api.onrender.com/v1/mcp` — no-install option
+
+### 3. Re-verify Smithery + MCP.so
+
+Two directories claimed in 17-day-old memory but never verified:
+
+- **Smithery**: go to https://smithery.ai and search `deckforge`. If missing, submit via their "Add server" flow pointing to `github.com/Whatsonyourmind/deckforge` with `server.json` at the root.
+- **MCP.so**: go to https://mcp.so and search. If missing, submit via their form.
+
+### 4. Glama tool inspection (bonus)
+
+Glama listing shows `tools: []` — likely because the Python server needs env vars to boot, so their inspector can't walk the tool list. Two options:
+
+- Add an optional `--dry-run` flag to `deckforge.mcp.server` that starts the server with in-memory stubs so Glama's inspector can enumerate tools
+- Or host a public streamable-http endpoint at `deckforge-api.onrender.com/v1/mcp` (already declared in server.json) and point Glama there via the "remote server URL" field on its dashboard
+
+Either path unlocks a B+ → A rating.

server.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.Whatsonyourmind/deckforge",
+  "description": "Generate executive-ready presentations from natural language or JSON IR. 32 slide types (23 universal + 9 finance), 24 chart types, 15 themes, native PPTX + Google Slides output. MCP tools: render, generate, list themes, list slide types, estimate cost, preview. Remote streamable-http endpoint available.",
+  "repository": {
+    "url": "https://github.com/Whatsonyourmind/deckforge",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "deckforge",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "runtimeArguments": [
+        {
+          "type": "positional",
+          "value": "-m",
+          "valueHint": "module"
+        },
+        {
+          "type": "positional",
+          "value": "deckforge.mcp.server",
+          "valueHint": "entrypoint"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "DECKFORGE_ANTHROPIC_API_KEY",
+          "description": "Anthropic API key for Claude content generation (one LLM key required)",
+          "isRequired": false,
+          "isSecret": true
+        },
+        {
+          "name": "DECKFORGE_OPENAI_API_KEY",
+          "description": "OpenAI API key for content generation",
+          "isRequired": false,
+          "isSecret": true
+        },
+        {
+          "name": "DECKFORGE_GEMINI_API_KEY",
+          "description": "Google Gemini API key",
+          "isRequired": false,
+          "isSecret": true
+        },
+        {
+          "name": "DECKFORGE_DATABASE_URL",
+          "description": "PostgreSQL connection string (defaults to SQLite for dev)",
+          "isRequired": false,
+          "isSecret": false
+        },
+        {
+          "name": "DECKFORGE_REDIS_URL",
+          "description": "Redis URL for queue + cache (default redis://localhost:6379/0)",
+          "isRequired": false,
+          "isSecret": false
+        }
+      ]
+    }
+  ],
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://deckforge-api.onrender.com/v1/mcp",
+      "description": "Remote MCP endpoint — production API on Render. No local install needed; point your MCP client here."
+    }
+  ]
+}