frontmcp-testing

A testing guide for FrontMCP servers, covering small component tests, integration tests, and end-to-end tests. End-to-end tests check a complete flow from start to finish.

In plain words
What is it for?
Use it to plan testing, configure Jest and coverage checks, test tools and other components, and investigate failed tests.
Why use it?
It helps you choose suitable tests, find coverage gaps, and check that server components behave correctly.

Skill for Claude CodeCodex

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 skills/agentfront/frontmcp/frontmcp-testing
Any agent
npx skills add agentfront/frontmcp --skill frontmcp-testing
Clone the repo
git clone --depth 1 https://github.com/agentfront/frontmcp

Made for: Claude Code, Codex.

Per session 175 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,079 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. 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.00175 $0.04079
Opus 5 $0.00088 $0.02039
Sonnet 5 $0.00035 $0.00816
Haiku 4.5 $0.00017 $0.00408

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

Security

Grade A, and why

frontmcp-testing scanned grade A with 1 finding 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

| Test CLI binary builds | `test-cli-binary` | Spawn-and-curl smoke tests for `frontmcp build --target cli` artifacts |
libs/skills/catalog/frontmcp-testing/SKILL.md · 231 lines

How it starts

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

FrontMCP Testing Router

Entry point for testing FrontMCP applications. This skill helps you navigate testing strategies across component types and find the right patterns for unit, integration, and E2E tests.

When to Use This Skill

Must Use

  • Setting up testing infrastructure for a new FrontMCP project
  • Deciding how to test a specific component type (tool, resource, prompt, agent)
  • Planning a testing strategy that covers unit, E2E, and coverage requirements

Recommended

  • Looking up testing patterns for a component type you haven't tested before
  • Understanding the relationship between unit tests, E2E tests, and coverage thresholds
  • Troubleshooting test failures or coverage gaps

Skip When

  • You need detailed Jest configuration and test harness setup (go directly to setup-testing)
  • You need to build components, not test them (see frontmcp-development)
  • You need to deploy, not test (see frontmcp-deployment)

Decision: Use this skill for testing strategy and routing. Open the setup-testing reference under references/ for hands-on Jest configuration and test writing.

Prerequisites

  • A FrontMCP project with at least one component to test (see frontmcp-development).
  • Jest installed and configured — if not, start with setup-testing before opening any other testing skill.
  • The component itself implemented and exported; tests reach decorated classes through the SDK, not by importing internal builders.

Steps

This is a router skill. Follow this order to pick a testing approach, then move to the target reference under references/.

  1. Pick the test layer — unit (fastest, mock DI), integration (real DI scope), or E2E (real MCP client + server). Use the Testing Strategy table below.
  2. Pick the component flavour — tool / resource / prompt / agent / job — each has a distinct recipe.
  3. Pick the runtime concern — auth, browser/CLI build, direct vs streamable transport — and add the matching reference to your reading list.
  4. Open the target reference (e.g. references/test-tool-unit.md, references/test-e2e-handler.md, references/test-auth.md) and follow its Steps section.
  5. Enforce coverage — confirm the project's 95%+ thresholds are wired into Jest before merging (see references/setup-testing.md).

Read the full file on GitHub · 231 lines

Files

What ships with it

25 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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 · 231 lines · 175 tokens per session scan A 891c2ed5417d

Subscribe to this mod's changes

frontmcp-testing is a skill published in the GitHub repository agentfront/frontmcp (147 stars, last pushed 26d ago), licensed Apache-2.0. It adds 175 tokens to every session and 4,079 once invoked, about $0.0009 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.