Wellness Manager

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

Contributing & support

• Bugs : https://github.com/WellnessAgent/wellness-master/issues
• Source : https://github.com/WellnessAgent/wellness-master

License

MIT © Wellness-Master.