wellness-master

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.

Related MCP server: @1ly/mcp-server

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

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.

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

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

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.