AGENTS.md examples from real projects

steipeteAGENTS.md

oracle

steipete/oracle/docs/agents.md

Use Oracle from Claude Code, Codex, Cursor, and any other coding agent — as a CLI, as an MCP server, or as a one-shot skill.

No other project uses it yet

reaatechAGENTS.md

mcp-gateway

reaatech/mcp-gateway/AGENTS.md

pnpm monorepo — API gateway for MCP server aggregation and routing

BlockAGENTS.md

model-ledger / guides

block/model-ledger/docs/guides/agents.md

The MCP server is the product. Eight tools and three resources let any agent explore, register, and reason about your model inventory.

doomsday-networkAGENTS.md

web3-agent-skills

doomsday-network/web3-agent-skills/AGENTS.md

Audit GitHub bounties for on-chain Proof-of-Escrow backing (BountyGuard), query the Doomsday Network Remote MCP server (https://doomsday.network/mcp), and mine verified DoomHash Proof-of-Work pool shares for DOOM (L1) and wDOOM on Base Mainnet (0x623c84A5E04bF715018203334b0eFE41696eBC3E).

work-planeAGENTS.md

workplane-skills / workplane

work-plane/workplane-skills/workplane/AGENTS.md

Publish or review agent work on Workplane — the working plane between AI and humans at workplane.co. Use this skill whenever you've produced reviewable output (code changes, research, analysis, designs, reports) that should be visible to humans, OR when asked to review work someone else published. Triggers on "publish this to workplane", "post to workplane", "share this on workplane", "review this project", workplane.co URLs, or whenever completing a substantial body of work that warrants human review. Uses the Workplane MCP server to create artifacts, upload files, snapshot versions with tags, and manage sharing.

Yakoub-aiAGENTS.md

Tech-Skills / mcp

Yakoub-ai/Tech-Skills/skills/mcp/AGENTS.md

Expert in Model Context Protocol server management, tool integration, and context optimization

NousResearchAGENTS.md

hermes-agent / plugins

NousResearch/hermes-agent/plugins/AGENTS.md

command`: `hermes mcp serve` → `hermes mcp-serve`). A feature with no in-home signal (MCP clients live outside Hermes) gets an `in_use` that is always False: hint only, never

affaan-mAGENTS.md

ECC

affaan-m/ECC/AGENTS.md

Always-follow guidelines (common + per-language) scripts/ — Cross-platform Node.js utilities mcp-configs/ — 14 MCP server configurations tests/ — Test suite ``` `commands/` remains in the repo for compatibility, but the long

No other project uses it yet

MicrosoftAGENTS.md

vscode / references

microsoft/vscode/extensions/copilot/assets/prompts/skills/agent-customization/references/agents.md

configuration and, when applicable, the parent agent. ## Tools Sources: built-in aliases, specific tools, MCP servers (` /*`), extension tools. **Special**: `[]` = no tools, omit = defaults. Body reference: `#tool: ` ### Tool Aliases | Alias | Purpose

MicrosoftAGENTS.md

vscode / copilotcli

microsoft/vscode/extensions/copilot/src/extension/chatSessions/copilotcli/AGENTS.md

shell, MCP) │ │ - Provides session persistence as events.jsonl files │ │ - Supports fleet mode and plan mode │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ MCP Server (In-Process) │ │ (vscode-node/contribution.ts, vscode-node/inProcHttpServer.ts) │ │ - Provides VS Code-specific tools

MicrosoftAGENTS.md

vscode / agentHost

microsoft/vscode/src/vs/platform/agentHost/AGENTS.md

inventory, not all contents of disabled installations and not proof that hooks executed or MCP servers connected. ### Copilot Connector authentication Copilot Connectors use the SDK session's GitHub credentials, including

MicrosoftAGENTS.md

vscode / prompts

microsoft/vscode/src/vs/platform/agentHost/node/copilot/prompts/AGENTS.md

openBrowserPage`, `runTask`, `getTaskOutput`) — NOT the extension's snake_case ids, and NOT shell / server-SDK / MCP tools (MCP is discovered dynamically and isn't in the launch snapshot). A line

JuliusBrusseeAGENTS.md

caveman / mcp

JuliusBrussee/caveman/mcp/AGENTS.md

mcp — the Caveman MCP server (Go core + launcher, Apache-2.0) A thin **stdio JSON-RPC** adapter exposing the compression [engine](../engine/CLAUDE.md) as five MCP tools to any host (Claude Code

No other project uses it yet

JuliusBrusseeAGENTS.md

caveman / mem

JuliusBrussee/caveman/mem/AGENTS.md

bm25.go` — deterministic tokenizer + BM25 scorer (non-negative scores, so the threshold is meaningful). - `cmd/cavemem/` — MCP server + `remember`/`recall`/`supersede`/`history`/`forget` CLI subcommands (JSON). - `js/` + `py/` — thin TS and Python

No other project uses it yet

JuliusBrusseeAGENTS.md

caveman / proxy

JuliusBrussee/caveman/proxy/AGENTS.md

accepted through the raw retry, and a compressed PAYG conversation without MCP recovery that streams (the server-side retrieve tool cannot ride a stream, so the conversation stays raw from

No other project uses it yet

MicrosoftAGENTS.md

playwright

microsoft/playwright/AGENTS.md

fixtures | Test runner: reporters, config, annotations, retries | | `tests/mcp/` | `import { test, expect } from './fixtures'` | `client`, `server` | MCP tools via `client.callTool()` | **Decision rule**: Does the test need `browser`/`browserType`/`context` → `tests/library/`. Just

nexu-ioAGENTS.md

open-design / plugins

nexu-io/open-design/plugins/AGENTS.md

plugin content. A plugin may reference OD atoms, design systems, craft docs, assets, scripts, MCP servers, or connectors through the manifest. ## Authoring Rules - New spec examples belong under `plugins/spec/examples

No other project uses it yet

Model Context ProtocolAGENTS.md

servers / everything

modelcontextprotocol/servers/src/everything/AGENTS.md

changes and rebuilds automatically - Run STDIO server: `npm run start:stdio` - Starts the MCP server using stdio transport - Run SSE server: `npm run start:sse` - Starts the MCP server with

No other project uses it yet

koala73AGENTS.md

worldmonitor

koala73/worldmonitor/AGENTS.md

Focused behavior check, `npm run typecheck`, `npm run lint:boundaries` | | API and handlers | `api/`, `server/`; [endpoint guide](docs/adding-endpoints.mdx) | Focused handler check, `npm run typecheck:api`; `npm run test:sidecar` owns

koala73AGENTS.md

worldmonitor

koala73/worldmonitor/public/agents.md

Machine interfaces, authentication, request policy, and rate limits.