node-mcp-template AGENTS.md

Repository instructions for a Node.js and TypeScript template used to build MCP servers. MCP is a standard way for AI tools to communicate with external tools and data.

In plain words
What is it for?
Use them when developing or checking an MCP server based on this template.
Why use it?
They specify the project’s file layout, formatting, type checking, linting, testing, and build commands, reducing setup and convention errors.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/0xfieldsy/node-mcp-template/agents-md
Clone the repo
git clone --depth 1 https://github.com/0xFieldsy/node-mcp-template

Made for: Codex, OpenCode.

Per session 335 This file is loaded in full into every session.
When invoked 335 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5 $0.00335 $0.00335
Opus 5 $0.00168 $0.00168
Sonnet 5 $0.00067 $0.00067
Haiku 4.5 $0.00034 $0.00034

Measured 2d ago against content hash 059c4bbfd2b0, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

node-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 2d 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.

AGENTS.md · 61 lines

What it actually says

node-mcp-template

This is a template for building stdio and Streamable HTTP Model Context Protocol servers in Node.js using TypeScript.

Tree

.
├── AGENTS.md
├── README.md
├── biome.json
├── notes
│   └── *.md
├── package.json
├── rolldown.config.ts
├── src
│   └── *.ts
├── test
│   └── *.test.ts
└── tsconfig.json

Formatting

Use StandardJS style:

printWidth: 100
tabWidth: 2
useTabs: false
semi: false
singleQuote: true
quoteProps: as-needed
trailingComma: none
bracketSpacing: true
objectWrap: preserve
arrowParens: always

TypeScript

Use npm run check to check for TypeScript errors. Use tsgo not tsc otherwise.

Local relative imports between TypeScript source files must include the .ts extension, e.g. ./lib/tools.ts.

Linting

Use npm run lint:fix to automatically fix errors with Biome.

Testing

Use npm run test to run tests with node --test. Write tests in ./test/*.test.ts using node:test and node:assert/strict.

Building

Use npm run build to strip types and bundle with Rolldown.

Notes

Search ./notes/*.md as a reference for building production servers using best practices.

Changes

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.

  1. 2d ago First seen · 61 lines · 335 tokens per session scan A 059c4bbfd2b0

Subscribe to this mod's changes

node-mcp-template AGENTS.md is an instructions file published in the GitHub repository 0xFieldsy/node-mcp-template (0 stars, last pushed 2mo ago), licensed Unlicense. It adds 335 tokens to every session, about $0.0017 per session on Opus 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-08-31.

Related

Other instructions, from other repositories

nodejs-starter CLAUDE.md

Instructions for threeal/nodejs-starter, covering claude.md, about this repository, architecture, source files and build outputs.

threeal/nodejs-starter · 773 tokens

qq-music-api AGENTS.md

Instructions for Rain120/qq-music-api, covering 🤖 qq music api - ai agents 指南 (agents.md), 🎯 目录, 项目概览, 项目架构 and 1. 服务端主链路.

Rain120/qq-music-api · 2,444 tokens

nextjs-css-agent-components AGENTS.md

Instructions for internet-development/nextjs-css-agent-components, covering agents.md, what this repo is, run / build, top-level layout and path aliases (tsconfig.json).

internet-development/nextjs-css-agent-components · 5,616 tokens

sportsdataverse-js CLAUDE.md

Instructions for sportsdataverse/sportsdataverse-js, covering claude.md — sportsdataverse (node.js) development guide, package overview, commit convention, branches and build & development commands.

sportsdataverse/sportsdataverse-js · 6,452 tokens

sportsdataverse-js copilot-instructions.md

Instructions for sportsdataverse/sportsdataverse-js, covering github copilot instructions — sportsdataverse (node.js), architecture (how the code is generated), conventions and commits / prs.

sportsdataverse/sportsdataverse-js · 1,238 tokens

node-express-boilerplate typescript-assertions.instructions.md

Use when editing TypeScript in src to avoid assertion-related lint/type regressions after merges. Prefer narrowing, type guards, satisfies, and as const/typeof over unsafe casts.

KhaledSaeed18/node-express-boilerplate · 344 tokens