Borrowing it
Nothing to install: this file belongs to adamwulf/mcp-template. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/adamwulf/mcp-template/main/AGENTS.mdgit clone --depth 1 https://github.com/adamwulf/mcp-templateWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/adamwulf/mcp-template/agents-md)<a href="https://agentmods.dev/instructions/adamwulf/mcp-template/agents-md"><img src="https://agentmods.dev/badge/instructions/adamwulf/mcp-template/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/adamwulf/mcp-template/agents-md"><img src="https://agentmods.dev/badge/instructions/adamwulf/mcp-template/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00742 | $0.00742 |
| Opus 5.5 | $0.00297 | $0.00297 |
| Sonnet 5.5 | $0.00148 | $0.00148 |
| Haiku 4.5 | $0.00074 | $0.00074 |
Grade A, and why
mcp-template AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 84 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Build and Test Commands
# Build the package
swift build
# Run tests
swift test
# Run the command line MCP server
swift run mcpexample run
# Format code using SwiftLint
./format-files.sh
# Build in Xcode (for iOS/macOS apps)
open MCPExample/MCPExample.xcworkspace
Architecture Overview
This repository provides a template for building MCP (Model Control Protocol) servers in Swift with three main components:
1. EasyMCP Library (Sources/EasyMCP/)
- Core MCP server implementation using the official
mcp-swift-sdk - Wraps the SDK to provide a simplified interface for registering tools and handling MCP communications
- Uses stdio transport for command-line MCP servers
- Key class:
EasyMCP- manages server lifecycle, tool registration, and MCP protocol handling
2. EasyMacMCP Library (Sources/EasyMacMCP/)
- Specialized implementation for macOS applications that need App Store compatibility
- Uses named pipes for inter-process communication between a sandboxed Mac app and a helper executable
- Enables MCP functionality in sandboxed environments where stdio access is restricted
- Key classes:
EasyMCPHost- Base class for managing pipe-based communication with helper processesMCPProtocols.swift- Protocol definitions for request/response communication- Pipe classes (
*Pipe.swift) - Handle reading/writing to named pipes
3. Command Line Example (Sources/mcpexample/)
- Demonstrates basic MCP server usage with
EasyMCP - Registers sample tools (
helloWorld,helloPerson,helloEveryone) - Shows how to handle tool registration, server startup, and graceful shutdown
- Uses
ArgumentParserfor CLI interface
4. macOS App Example (MCPExample/)
- Xcode workspace demonstrating App Store-safe MCP integration
- Main app uses
EasyMacMCPto communicate with a helper executable via named pipes - Helper executable (
mcp-helper) runs the actual MCP server usingEasyMCP - Shows how to build MCP functionality that works within macOS sandboxing restrictions
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 84 lines · 742 tokens per session scan A 335d5e23b63d
mcp-template AGENTS.md is an instructions file published in the GitHub repository adamwulf/mcp-template (17 stars, last pushed 6d ago), licensed MIT. It adds 742 tokens to every session, about $0.0030 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-02.
mcp-template AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| mcp-template AGENTS.mdadamwulf/mcp-template | Instructions file | 17 | 6d ago | MIT | A | 742 | Codex, OpenCode |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | today | MIT | A | 7,461 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 5,516 | GitHub Copilot |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | today | MIT | A | 4,680 | Codex, OpenCode |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 275k | 3d ago | MIT | A | 4,313 | Codex, OpenCode |