From bde8999bee756b299a46602e9e1394dc8824fb29 Mon Sep 17 00:00:00 2001
From: Nick Rygiel <nick@protocolwealthllc.com>
Date: Thu, 4 Jun 2026 15:51:47 -0400
Subject: [PATCH] docs: add 'Using with any MCP client' snippet to README +
 mcp-guide

Any MCP-compatible AI client (Claude, GPT, Gemini) can register the public
read-only https://nexusmcp.site/mcp endpoint. Factual interop note, no vendor
relationship claim.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 README.md                       | 17 +++++++++++++++++
 src/nexus_core/app/mcp_guide.py |  2 ++
 2 files changed, 19 insertions(+)

diff --git a/README.md b/README.md
index 40cefa0..5e6d29f 100644
--- a/README.md
+++ b/README.md
@@ -274,6 +274,23 @@ interactive docs at `/docs`, and an MCP endpoint at `/mcp`. See
 [DEPLOY.md](DEPLOY.md) for the Cloud Run + Cloud SQL + Cloud Scheduler
 deployment.
 
+### Using with any MCP client
+
+The hosted MCP endpoint is public and read-only, so any MCP-compatible AI client (Claude, GPT, Gemini) can register `https://nexusmcp.site/mcp` as a read-only MCP server — no account, no API key, no auth. For example, in a `.mcp.json` (or any client config that follows the same shape):
+
+```json
+{
+  "mcpServers": {
+    "nexus-core": {
+      "type": "http",
+      "url": "https://nexusmcp.site/mcp"
+    }
+  }
+}
+```
+
+See the [MCP setup guide](https://nexusmcp.site/mcp-guide) for per-client steps (Claude.ai, Claude Code, Claude Desktop, and other clients) and `tools/list` output.
+
 ## Configuration
 
 All configuration is environment-driven. Every variable is optional; the app
diff --git a/src/nexus_core/app/mcp_guide.py b/src/nexus_core/app/mcp_guide.py
index 33ec987..1725a74 100644
--- a/src/nexus_core/app/mcp_guide.py
+++ b/src/nexus_core/app/mcp_guide.py
@@ -139,6 +139,8 @@
   <p>
     Most clients that support remote MCP servers accept the URL directly — point
     them at <code>{mcp_url}</code> with the HTTP / Streamable-HTTP transport.
+    Any MCP-compatible AI client (Claude, GPT, Gemini) can register this
+    read-only endpoint the same way — no account, no API key, no auth.
   </p>
   <div class="note">
     <strong>Tools not showing up?</strong> Fully quit and reopen Claude Desktop