mcp-app-typescript-template AGENTS.md

mcp-app-typescript-template AGENTS.md is an instructions file for Codex, OpenCode from pomerium/mcp-app-typescript-template. It costs 5,171 tokens per session, scanned A, original, Apache-2.0.

Repository instructions for an MCP Apps template: a project where AI tools connect to interactive React views through the Model Context Protocol.

In plain words
What is it for?
Use them when installing dependencies, starting the server and widget development tools, or changing the MCP backend and its interactive widgets.
Why use it?
They give coding agents the project layout, setup steps, and available commands so they can work in the repository without guessing.

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/pomerium/mcp-app-typescript-template/agents-md
Clone the repo
git clone --depth 1 https://github.com/pomerium/mcp-app-typescript-template

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-app-typescript-template AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/pomerium/mcp-app-typescript-template/agents-md.svg)](https://agentmods.dev/instructions/pomerium/mcp-app-typescript-template/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/pomerium/mcp-app-typescript-template/agents-md"><img src="https://agentmods.dev/badge/instructions/pomerium/mcp-app-typescript-template/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 5,171 This file is loaded in full into every session.
When invoked 5,171 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.05171 $0.05171
Opus 5 $0.02586 $0.02586
Sonnet 5 $0.01034 $0.01034
Haiku 4.5 $0.00517 $0.00517

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

Security

Grade A, and why

mcp-app-typescript-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 4d 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 · 538 lines

How it starts

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

Repository Guidelines

This file provides guidance to AI assistants (including Claude Code at claude.ai/code) when working with code in this repository.

Project Overview

This is an MCP Apps template built with the MCP Apps spec and Model Context Protocol (MCP). The architecture consists of:

  • MCP Server (Node.js + Express): Handles tool registration, execution, and widget resource serving
  • MCP App Views: Interactive components rendered in host iframes that communicate via the MCP Apps App API
  • Widget Build System: Custom Vite-based parallel build pipeline with content hashing and auto-discovery

npm workspaces split the codebase: server/ is the MCP backend and widgets/ houses React widgets.

Development Commands

Quick Start

Fastest way to get up and running:

npm install
npm run dev

This starts both the MCP server (http://localhost:8080) and widget dev server (http://localhost:4444).

All Available Commands

Development:

npm run dev               # Start everything (server + widget dev server + background watch build)
npm run dev:inline        # Force inlined assets for every client (rarely needed)
npm run dev:server        # Start only MCP server (watch mode)
npm run dev:widgets       # Start only widget dev server
npm run dev:widgets:build # Start only the widget watch build
npm run inspect           # Test with MCP Inspector

npm run dev needs no manual build step: a background vite build --watch keeps assets/ fresh, and the server decides per MCP request whether to serve live dev-server modules (HMR) or fully inlined HTML, based on the requesting client (see "Per-Client Widget HTML" below).

Building:

npm run build         # Full production build (widgets + server)
npm run build:widgets # Build only widgets
npm run build:server  # Build only server

Testing:

npm test              # Run all tests
npm run test:server   # Run server tests only
npm run test:widgets  # Run widget tests only
npm run test:coverage # Run tests with coverage

Read the full file on GitHub · 538 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. 4d ago Changed · +15 lines · +540 tokens per session 64f94f308a0d
  2. 5d ago First seen · 523 lines · 4,631 tokens per session scan A e18e9c098652

Subscribe to this mod's changes

mcp-app-typescript-template AGENTS.md is an instructions file published in the GitHub repository pomerium/mcp-app-typescript-template (20 stars, last pushed today), licensed Apache-2.0. It adds 5,171 tokens to every session, about $0.0259 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-30.