From d7a10f4212e92c6cc756b6f734e01dd0b08ac4de Mon Sep 17 00:00:00 2001
From: "Thomas G. Lopes" <thomasgl@pm.me>
Date: Tue, 3 Mar 2026 17:23:27 +0000
Subject: [PATCH] better mcp

---
 pi/files/agent/AGENTS.md | 37 +++++++++++++++++++++++++++++++++++++
 pi/files/agent/mcp.json  | 12 ------------
 2 files changed, 37 insertions(+), 12 deletions(-)
 delete mode 100644 pi/files/agent/mcp.json

diff --git a/pi/files/agent/AGENTS.md b/pi/files/agent/AGENTS.md
index 3a48e5f..8c76220 100644
--- a/pi/files/agent/AGENTS.md
+++ b/pi/files/agent/AGENTS.md
@@ -27,3 +27,40 @@ When making changes:
 - GraphQL mutations like `addPullRequestReviewThreadReply`, `addPullRequestReviewComment`, etc.
 
 The agent must only read PR information and make code changes. The user will post their own comments.
+
+---
+
+# MCP Usage (mcporter)
+
+Use [mcporter](https://github.com/steipete/mcporter) to call MCP servers. It auto-discovers servers from editor configs (Cursor, Claude, Windsurf, etc.) and supports ad-hoc connections.
+
+```bash
+# List available servers and tools
+npx mcporter list
+npx mcporter list <server> --schema
+
+# Call tools (two syntax styles)
+npx mcporter call <server>.<tool> arg1:value1 arg2:value2
+npx mcporter call '<server>.<tool>(arg1: "value1", arg2: "value2")'
+
+# Ad-hoc HTTP server (no config needed)
+npx mcporter call https://mcp.example.com/mcp.<tool> arg:value
+
+# Ad-hoc stdio server
+npx mcporter call --stdio "bun run ./server.ts" <tool> arg:value
+
+# Generate TypeScript types
+npx mcporter emit-ts <server> --mode types
+```
+
+Config location: `~/.mcporter/mcporter.json` (or `config/mcporter.json` in project)
+
+## Commonly Used MCP Servers
+
+Only use these servers and read about them when applicable.
+
+### Svelte
+
+Use frequently within Svelte 5 projects.
+
+- URL: `https://mcp.svelte.dev/mcp`
diff --git a/pi/files/agent/mcp.json b/pi/files/agent/mcp.json
deleted file mode 100644
index 892c476..0000000
--- a/pi/files/agent/mcp.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
-  "settings": {
-    "idleTimeout": 10
-  },
-  "mcpServers": {
-    "svelte": {
-      "type": "http",
-      "url": "https://mcp.svelte.dev/mcp",
-      "tools": ["*"]
-    }
-  }
-}