a5c-ai/babysitter / library/specializations/ai-agents-conversational/skills/mcp-app-verification
mcp-app-verification
VerifiedComprehensive verification checklists for MCP Apps. Tests with basic-host reference, validates handler-before-connect, text fallback, resource URI linking, single-file bundling, host styling, CSP, and legacy pattern detection.
README.md
View on GitHub# MCP App Verification Skill
## Overview
The `mcp-app-verification` skill provides comprehensive verification checklists for MCP Apps. It validates critical invariants (handler-before-connect, text fallback, resource URI linking), build correctness (single-file bundling), styling integration, CSP configuration, and migration completeness.
## Key Features
- **basic-host Testing**: Launch the SDK's reference host to test your app end-to-end
- **Pattern Verification**: Automated checks for handler-before-connect, text fallback, RESOURCE_MIME_TYPE
- **Build Validation**: Verify single-file bundle is self-contained
- **Styling Checks**: CSS variable fallback presence and theme handler registration
- **CSP Audit**: Compare declared CSP domains against actual network origins
- **Migration Scanning**: Detect remaining legacy patterns (OpenAI, old MIME types, snake_case)
## Prerequisites
1. SDK reference code cloned at `/tmp/mcp-ext-apps/`
2. Application build toolchain working
3. grep/ripgrep available for pattern searching
## Quick Start
### Build and Verify
```bash
# Build
npm run build
# Check single-file bundle
ls dist/mcp-app.html
# Check handler-before-connect
grep -n 'app\.connect\|\.ontoolinput\|\.ontoolresult' src/main.ts
# Test with basic-host
npm run serve &
cd /tmp/mcp-ext-apps/examples/basic-host
SERVERS='["http://localhost:3001/mcp"]' npm run start
```
### Migration Check
```bash
# Search for legacy patterns (should all return zero)
grep -rn 'window\.openai' src/
grep -rn 'text/html+skybridge' src/
grep -rn '_domains"' src/
```
## Verification Dimensions
| Dimension | What It Checks |
|-----------|---------------|
| Runtime | App loads in basic-host, handlers fire, no console errors |
| Patterns | Handler-before-connect, text fallback, RESOURCE_MIME_TYPE |
| Build | Single-file bundle exists and is self-contained |
| Styling | CSS variable fallbacks, onhostcontextchanged handler |
| CSP | All origins declared, correct placement, conditional matching |
| Migration | Zero legacy patterns remaining |
## Integration with Babysitter Processes
| Process | Integration Point |
|---------|------------------|
| create-mcp-app.js | Phases 7-8: Implementation review and verification |
| add-app-to-mcp-server.js | Phase 7: Backward compatibility verification |
| convert-web-app-to-mcp.js | Phase 8: Dual-mode verification |
| migrate-openai-app-to-mcp.js | Phases 7-8: Before-finishing checklist and verification |
## References
- [MCP Apps Testing Guide](https://github.com/modelcontextprotocol/ext-apps/blob/main/docs/testing-mcp-apps.md)
- [basic-host Reference](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-host)
## Related Resources
- mcp-tool-resource-pattern - What this skill verifies on the server side
- mcp-host-styling-integration - What this skill verifies on the client side
- mcp-csp-investigation - Deeper CSP auditing beyond verification
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |