mcp-client-gen: Instructions file for Codex

AGENTS.md

mcp-client-gen AGENTS.md is an instructions file for Codex, OpenCode from kriasoft/mcp-client-gen. It costs 1,771 tokens per session, scanned A, original, MIT.

Project instructions for mcp-client-gen, a tool that turns an MCP server into a type-safe TypeScript software-development kit. MCP is a way for an AI client to connect to external tools or data.

In plain words
What is it for?
Use it when working on the mcp-client-gen project or generating TypeScript clients for MCP servers with OAuth and multiple provider options.
Why use it?
It gives the project instructions for generating more predictable TypeScript code and supporting sign-in through OAuth 2.1.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md.

This is kriasoft/mcp-client-gen's own configuration. It tells Codex and OpenCode how to work on mcp-client-gen itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything mcp-client-gen configures →

Reuse

Borrowing it

Nothing to install: this file belongs to kriasoft/mcp-client-gen. 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/kriasoft/mcp-client-gen/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/kriasoft/mcp-client-gen

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.

agentmods badge for mcp-client-gen AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/kriasoft/mcp-client-gen/agents-md/github.svg)](https://agentmods.dev/instructions/kriasoft/mcp-client-gen/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/kriasoft/mcp-client-gen/agents-md"><img src="https://agentmods.dev/badge/instructions/kriasoft/mcp-client-gen/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.

agentmods 80×15 button for mcp-client-gen AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/kriasoft/mcp-client-gen/agents-md"><img src="https://agentmods.dev/badge/instructions/kriasoft/mcp-client-gen/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,771 This file is loaded in full into every session.
When invoked 1,771 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.01771 $0.01771
Opus 5.5 $0.00708 $0.00708
Sonnet 5.5 $0.00354 $0.00354
Haiku 4.5 $0.00177 $0.00177

Measured 21d ago against content hash cd21e78df6a8, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

mcp-client-gen 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 21d 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 · 157 lines

How it starts

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

MCP Client Generator

@AGENTS.local.md

Documentation

Start with docs/architecture.md: pipeline, module boundaries, invariants, and which document to read for a change.

  • SPECs (docs/specs/{name}.md, referenced as SPEC-{name}): what the system does — api, generated-client, introspection, cli, config. Specs are the contract; update them in the same commit as the code.
  • ADRs (docs/adr/NNN-slug.md, referenced as ADR-NNN): why, and what was rejected — 001 pipeline, 002 OAuth, 003 generator not runtime, 004 schema typing, 005 config and secrets. Revise in place when a decision changes (see 000-template.md).
  • local/ is gitignored scratch (review handoffs, drafts); never a source of truth.

Run Commands

# URL mode (primary)
npx mcp-client-gen <url>                    # Generate to stdout
npx mcp-client-gen <url> -o <file>          # Generate to file

# Config mode (uses .mcp.json, .cursor/, .vscode/): one module per server, written only after every server succeeds
npx mcp-client-gen                          # Interactive
npx mcp-client-gen -y                       # Quick defaults (src/mcp/ or mcp/)
npx mcp-client-gen -o <dir>                 # Quick, custom output directory (implies -y)
npx mcp-client-gen ... --no-oauth           # Either mode: fail instead of opening a browser
npx mcp-client-gen ... --oauth-port 8080    # Either mode: OAuth redirect on another loopback port

Test Commands

bun test                        # Unit tests only (src/)
bun test:e2e                    # E2E tests only (test/e2e/)
bun test:all                    # Run all tests
bun typecheck                   # TypeScript check
bun format                      # Format code with Prettier
bun format:check                # Check code formatting
bun validate                    # Full validation (format, typecheck, tests)
bun run build && bun smoke:package  # Packed tarball under Node: CLI, library, generated code (release gate)

Manual Test Scripts

Read the full file on GitHub · 157 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.

  1. 21d ago Changed · +154 lines · +1,759 tokens per session cd21e78df6a8
  2. 1mo ago First seen · 3 lines · 12 tokens per session scan A 05b48ba72bef

Subscribe to this mod's changes

mcp-client-gen AGENTS.md is an instructions file published in the GitHub repository kriasoft/mcp-client-gen (20 stars, last pushed 21d ago), licensed MIT. It adds 1,771 tokens to every session, about $0.0071 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-30.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,649 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,549 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens