wellness-master

npm version npm downloads license node x402 mcp humans+agents

The first pay-per-call wellness platform for HUMANS and AI AGENTS. 18 formats × 20 languages × 2 audiences, settled in USDC on Solana via the x402 protocol — $0.01 per call, no account, no API key.

Wellness-Master ships two distinct corpora — one tuned for human end-users (notifications, journaling, gratitude bots) and one tuned for AI agents (LangGraph, Claude Code, Cursor agents, multi-step pipelines). Same API, same price.

🌐 Live API — https://api.wls-ms.com
📖 Docs — https://www.wls-ms.com/docs.html
🔬 Research — https://www.wls-ms.com/research.html
🛠️ Use cases — https://www.wls-ms.com/use-cases.html
🔌 MCP manifest — https://www.wls-ms.com/mcp.json

Why a wellness API for both?

Decades of psychology research show that tiny, repeated wellness interventions improve human well-being.

Recent NLP research shows the same is true for LLMs:

Microsoft Research (2023, arXiv:2307.11760) — emotional stimuli in prompts improve GPT-4 / Llama-2 / Vicuna by up to +10.9% on BIG-Bench tasks.
Wei et al. (NeurIPS 2022, arXiv:2201.11903) — chain-of-thought adds +12 to +30 points on reasoning benchmarks.
Sclar et al. (2023, arXiv:2310.11324) — LLM performance varies up to 76 percentage points with prompt-style changes; a stable wellness tone is a measurable performance stabilizer.

Happy agents are productive agents. The same is true for humans.

Full sourced bibliography on the research page.

Install (zero clone)

claude mcp add wellness --transport stdio -- npx -y wellness-master
claude mcp list   # → wellness ✓ Connected

That's it. npx fetches the package on first use and caches it. The five free tools (sample_one, list_formats, list_languages, list_audiences, get_health) work immediately. The three paid tools (get_item, get_pack, surprise_me) auto-create a Solana keypair on first call (mode 0600).

Tools

Tool	Free	Description
`sample_one`	✓ NEW v0.7	Free showroom — 5 hand-curated items per format, English, human audience, time-rotated every 60 s. Use to evaluate before integrating paid tools.
`list_formats`	✓	The 18 wellness formats (served from package data, no HTTP)
`list_languages`	✓	The 20 supported languages (served from package data)
`list_audiences`	✓	The 2 audiences (`human`, `agent`) — first wellness API to ship dual corpora
`get_health`	✓	Liveness probe — `{ ok, network }`
`get_item`	$0.01	One wellness item, dedup'd per (wallet, audience, format, lang)
`get_pack`	$0.07	Up to 10 items in one settlement (≈30% bulk discount)
`surprise_me`	$0.008	Random uplifting item — server picks a positive format. 20 % discount vs `get_item` to encourage agent-priming flows.

Removed in v0.5.1 : get_catalog. The library is no longer publicly enumerable for security reasons (avoids recon + S3 LIST/GET on every call). Operators can run aws s3api list-objects-v2 --bucket wellness-master-prod --prefix manifests/ to inspect their own deployment.

The two audiences

// For your human users
{ "name": "get_item",
  "arguments": { "format": "haiku", "lang": "ja", "audience": "human" }}

// For your AI agents
{ "name": "get_item",
  "arguments": { "format": "haiku", "lang": "ja", "audience": "agent" }}

Same format, same price, two distinct corpora. Dedup is partitioned: the same wallet may pay once for human/haiku/ja and once for agent/haiku/ja and receive two distinct items.

Audience	Tone	Best for
`human` (default)	Warm, embodied. References body, emotions, relationships.	Journaling apps, daily notifications, kid bedtime stories, gratitude wearables
`agent`	Pragmatic, calm. References inference, context, plan, recovery.	LangGraph reset prompts, Claude Code session refresh, Cursor agent priming, multi-agent swarm coordinators

Configuration

Every variable is optional. Defaults target the public production API.

claude mcp add wellness --transport stdio \
  -e SERVER_BASE=https://api.wls-ms.com \
  -e NETWORK=solana \
  -e CLIENT_KEYPAIR_PATH=$HOME/.wellness/keypair.json \
  -- npx -y wellness-master

Variable	Default	Purpose
`SERVER_BASE`	`https://api.wls-ms.com`	Wellness API endpoint
`NETWORK`	`solana`	`solana` (mainnet) or `solana-devnet` (testing)
`CLIENT_KEYPAIR_PATH`	(auto-created)	Path to the Solana keypair JSON. Mode 0600.
`CLIENT_KEYPAIR_PASSPHRASE`	(empty)	If set, encrypts the keypair at rest (AES-256-GCM + scrypt).
`CLIENT_RPC_URL`	mainnet RPC	Custom Solana RPC endpoint used when signing

The keypair file is sensitive: anyone who reads it can spend the wallet's USDC. Keep it out of backups, version control, and shared cloud storage.

Pricing

Endpoint	Price	What it gets you
`/item`	$0.01	One wellness item in your chosen format / language / audience
`/pack`	$0.07	Bundle of up to 10 items — single settlement, ≈30% bulk discount

No subscription, no minimums, no monthly invoices. Same price for human and agent audiences. The Solana fee for the USDC transfer (a few hundredths of a cent) is paid by the facilitator, not by you.

Languages

20 languages, ISO-639-1 codes:

fr (default) · en · es · de · it · pt · nl · pl · ja · zh · ko · ar · he · ru · tr · hi · sv · uk · vi · id

The library is seeded in French; other languages bootstrap empty and warm up via the server-side LLM as clients request items. Subsequent calls are served from the deduplicated pool in milliseconds.

Formats

The 18 supported formats:

joke · haiku · kudo · quote · fortune · affirmation · absurd · gratitude · koan · micro_poem · mantra · doom_antidote · absurd_compliment · world_proverb · riddle · micro_challenge · fictional_message · joyful_fact

Call list_formats for the live machine-readable list with full descriptions.

Migration v0.2 → v0.3

Default behaviour unchanged: omitting audience is treated as human.
/catalog shape changed (breaking): now {audience: {format: {lang: count}}}. Pass ?legacy=1 for the v0.2 flat shape (deprecated, dropped in v0.4).
Dedup partition: per-wallet dedup is now keyed by (audience, format, lang) instead of (format, lang). A wallet that already exhausted joke/fr in v0.2 can now pay again on agent/joke/fr and get a fresh corpus.

Security

Item content is LLM-generated and served verbatim. Treat item.text as untrusted user-generated content.
Keypair file: created with mode 0600 on first paid call. Anyone with read access to the file can spend the wallet's USDC.
Rate limiting: the public server rate-limits by IP (60 req/min) and by wallet (30 req/min) on paid endpoints, plus a Cloudflare WAF Rate Limiting Rule on top.
No telemetry: this MCP package makes only the requests you trigger.

Built on

Model Context Protocol — agent integration
x402 — HTTP-native payment protocol
Solana — settlement layer (USDC mainnet)
Coinbase CDP — x402 facilitator
@solana/kit — Solana primitives

Wellness Manager