From 442284c92f9ce5bfe0b37efa5f207e3a895536c6 Mon Sep 17 00:00:00 2001
From: "Thomas G. Lopes" <thomasgl@pm.me>
Date: Fri, 13 Mar 2026 11:01:35 +0000
Subject: [PATCH] add mcporter mcp config steps

---
 pi/files/agent/AGENTS.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/pi/files/agent/AGENTS.md b/pi/files/agent/AGENTS.md
index c1296c6..3f6655d 100644
--- a/pi/files/agent/AGENTS.md
+++ b/pi/files/agent/AGENTS.md
@@ -61,6 +61,27 @@ npx mcporter emit-ts <server> --mode types
 
 Config location: `~/.mcporter/mcporter.json` (or `config/mcporter.json` in project)
 
+### configuring servers quickly
+
+```bash
+# add a server to project-local config
+npx mcporter config add <name> <url>
+# example
+npx mcporter config add svelte https://mcp.svelte.dev/mcp
+
+# verify server + tool schemas
+npx mcporter list
+npx mcporter list svelte --schema
+
+# inspect exact merged config source
+npx mcporter config list --json
+
+# if OAuth server, complete auth
+npx mcporter auth <name>
+```
+
+If `mcporter list` shows no servers, first run `npx mcporter config add ...` (or import from editor config with `npx mcporter config import cursor --copy`).
+
 ## Commonly Used MCP Servers
 
 Only use these servers and read about them when applicable.