What is scratchpad-mcp AGENTS.md?

Repository guidance for scratchpad-mcp, a TypeScript service with tools, a database layer, tests, and a web viewer. MCP is a standard way for an AI assistant to connect to external tools or data.

Use it when developing, testing, type-checking, linting, formatting, or serving the scratchpad-mcp project.

It records the expected project layout, coding rules, and checks needed before changes are accepted.

How pc035860/scratchpad-mcp configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to pc035860/scratchpad-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/pc035860/scratchpad-mcp/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/pc035860/scratchpad-mcp

Made for: Codex, OpenCode.

Wrote 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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/pc035860/scratchpad-mcp/agents-md/github.svg)](https://agentmods.dev/instructions/pc035860/scratchpad-mcp/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/pc035860/scratchpad-mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/pc035860/scratchpad-mcp/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.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/pc035860/scratchpad-mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/pc035860/scratchpad-mcp/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 651 This file is loaded in full into every session.

When invoked 651 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

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.

Model	Per session	Once invoked
Fable 5.1	$0.00651	$0.00651
Opus 5.5	$0.00260	$0.00260
Sonnet 5.5	$0.00130	$0.00130
Haiku 4.5	$0.00065	$0.00065

Measured 2mo ago against content hash 7dd5ad98f77b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

scratchpad-mcp 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 2mo 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 · 43 lines

How it starts

The opening of the file, as written. The whole thing — 43 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Repository Guidelines

Project Structure & Module Organization

src/: TypeScript source. Entry: src/server.ts; helpers in src/server-helpers.ts; modules in src/tools/ and src/database/.
tests/: Vitest specs (*.test.ts).
scripts/: Utilities and serve-workflow/ web viewer.
dist/: Build output (generated by tsup). Do not edit.
extensions/ + dict (symlink): Optional Chinese tokenization assets.

Build, Test, and Development Commands

npm run dev: Watch build with tsup for rapid iteration.
npm run build: Produce ESM bundle in dist/.
npm test / npm run test:watch: Run Vitest once / in watch mode.
npm run typecheck: Strict TypeScript type checks (tsc --noEmit).
npm run lint / npm run lint:fix: ESLint validate / autofix.
npm run format: Prettier format src/**/*.ts.
npm run serve / npm run serve:dev: Launch workflow web viewer.

Coding Style & Naming Conventions

TypeScript strict mode; no any, explicit return types, prefer const.
Formatting: Prettier (2 spaces, single quotes, semicolons, LF, width 100).
Linting: ESLint with @typescript-eslint rules enforced in CI/local.
File names: prefer kebab-case (server-helpers.ts, tools/search.ts). Some database classes use PascalCase files (e.g., ScratchpadDatabase.ts).
Exports: favor named exports; functions/vars use lowerCamelCase; types/interfaces PascalCase.

Testing Guidelines

Framework: Vitest (tests/**/*.test.ts). Example: tests/extraction.test.ts.
Coverage: v8 provider with text/json/html reporters. Keep or improve coverage for touched files.
Write deterministic, unit-level tests near affected modules; avoid I/O in pure unit tests.
Run locally: npm test; for TDD use npm run test:watch.

Commit & Pull Request Guidelines

Commits follow Conventional Commits (e.g., feat(core): ..., fix(database): ..., docs: ...).
Scope changes logically; keep messages imperative and concise.
PRs must include: clear description, linked issues, test coverage for changes, and docs updates (README/AGENTS.md) when behavior or commands change.
For web viewer changes, add before/after screenshots when feasible.

Read the full file on GitHub · 43 lines

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.

2mo ago First seen · 43 lines · 651 tokens per session scan A 7dd5ad98f77b

Subscribe to this mod's changes

scratchpad-mcp AGENTS.md is an instructions file published in the GitHub repository pc035860/scratchpad-mcp (5 stars, last pushed 1y ago), licensed MIT. It adds 651 tokens to every session, about $0.0026 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-08-31.

scratchpad-mcp AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
scratchpad-mcp AGENTS.mdpc035860/scratchpad-mcp	Instructions file	5	1y ago	MIT	A	651	Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

scratchpad-mcp: Instructions file for Codex