From d87d0a61e4ead979dca1982756f74b27612413a2 Mon Sep 17 00:00:00 2001
From: Nirupam Bhowmick <48842933+heydryft@users.noreply.github.com>
Date: Fri, 23 Oct 2026 15:13:34 +0100
Subject: [PATCH] docs: lead the MCP section with the one line for the agent

The AI clients section opens with the line to paste into an agent (it reads https://runcrate.ai/mcp.md and adds the server), then runcrate mcp install.
---
 README.md | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 7303df0..6532860 100644
--- a/README.md
+++ b/README.md
@@ -151,9 +151,16 @@ secret of the same name.
 
 ## AI clients (MCP)
 
-Runcrate runs a remote MCP server at `https://mcp.runcrate.ai/mcp`. One command
-adds it to your AI clients; each one opens your browser to sign in on first use.
-No key to paste.
+Runcrate runs a remote MCP server at `https://mcp.runcrate.ai/mcp`. The quickest
+way in is one line pasted into your agent (Claude Code, Codex, Cursor, VS Code,
+OpenCode or any agent that runs commands). It adds the server to itself, and the
+first Runcrate tool call opens your browser to sign in. No key to paste.
+
+```text
+Add Runcrate's MCP server to yourself: run curl -fsSL "https://runcrate.ai/mcp.md" and follow it.
+```
+
+From a terminal, one command adds it to every AI client on this machine instead:
 
 ```bash
 runcrate mcp install                            # every client found on this machine