Value-Wall Monetisation Layer for MCP Tools. Add x402 payments to your MCP server in one line.
VAULLS is a payment-gating library, not a production MCP server. The 13 tools span multiple example files (demo/server.py, examples/fastapi_server.py, examples/fastmcp_server.py) with inconsistent schemas and descriptions. Most tools have minimal descriptions (10-30 chars), no input parameter descriptions, and vague or missing output schemas. Tool naming is generic (ping, health, free_lookup) without clear action verbs. Parameters like 'data' lack type specificity and descriptions. Error handling is absent from visible code. The library itself provides @paywall decorator and middleware, but the example tools do not demonstrate production-grade definition quality.
Deep research on a topic — costs $0.15. Accepts Base or Base Sepolia.
This tool costs $0.25 USDC per call. Accepts Base mainnet or testnet.
Check if a claim is accurate. First 10 calls free.
This tool is free — no paywall.
Returns something unexpectedly valuable.
Get the weather forecast for a city.
Free endpoint
Parameter descriptions missing or trivial. Tools like free_lookup, premium_analysis, expert_review, quick_check accept a 'data' parameter with only 'Query data', 'Analysis data', 'Review data', 'Check data', no guidance on structure, required fields, or format.
Tool descriptions under 20 characters or generic. 'Free endpoint', 'Free health-check tool', 'Check if the server is alive' lack context for LLM selection. No guidance on when to call each tool vs alternatives.
Output schemas not documented. No visible return type definitions for any tool. LLMs cannot plan downstream calls or extract required fields (e.g., does vaulls_pricing return a list of tools with prices, or a dict mapping tool names to prices?).
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | <=2025-11-25 | v2 |
Free health-check tool. Must pass through the middleware without a 402.
Check if the server is alive.
This tool costs $0.10 USDC per call.
First 5 calls free, then $0.02 per call.
Health check for the VAULLS payment layer.
Discover pricing for all paywalled tools on this server.
Duplicate tool names. 'ping' appears twice (demo/server.py and examples/fastmcp_server.py) with identical descriptions. LLMs cannot disambiguate which to call.
Generic parameter names without type hints. 'data' parameter in 5 tools lacks type specification (object, string, array?). No enum constraints, format patterns, or length limits documented.