FastMCP tests
SkillDocs & knowledgeGuides your agent to write regression tests for FastMCP changes using pytest fixtures and in-memory clients.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the FastMCP tests skill
About this capability
Write regression tests for FastMCP changes using its pytest fixtures, in-memory clients, and protocol boundaries.
What this skill tells your AI
The instructions your AI receives, as published by prefecthq/fastmcp in .agents/skills/python-tests/SKILL.md and read by ahel’s review.
Read nearby tests and the repository's validation requirements first. Extend the owning test module when it remains readable; use a focused module when the existing one is already too large.
For a bug fix, run the regression against unchanged code and confirm it fails for the reported reason, then run it with the fix. An import error or broken fixture is not a reproduced bug. Include supported adjacent behavior that the same branch could change, especially omitted defaults and explicit overrides.
- Async tests need no marker:
asyncio_mode = "auto"is configured globally. - Use
Client(server)for real MCP dispatch without a network server. Use HTTP transport only when network behavior is the subject. - Mock external boundaries, not the FastMCP functions under test. For OpenAPI requests, capture the outgoing request with
httpx2.MockTransportand assert its bytes, headers, or decoded parameters. - Keep imports at module scope. Prefer function-scoped fixtures and
tmp_pathfor files. - Parameterize variations of one contract; separate unrelated behavior. For JSON, equality alone does not distinguish
Truefrom1: check the resulting type when type preservation matters. - Use existing
inline_snapshotconventions for complex schema assertions. Inspect generated snapshots rather than accepting them blindly. - The default timeout is five seconds. Use the repository's integration conventions for tests that legitimately need more time.
Run focused tests during development, then the full commands required by AGENTS.md before committing. If a failure appears unrelated, reproduce it on the unchanged base; do not call it pre-existing from the test name alone.
Signals
- GitHub stars
- 28k
- Forks
- 2k
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
python-tests- Source
- github.com/prefecthq/fastmcp