Install in 1 command

Register the MCP server with any stdio-MCP client (Claude Code, Claude Desktop, Cursor). 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).

claude mcp add wellness --transport stdio -- npx -y wellness-master

MCP integration details →

Or try without installing — free showroom, no wallet:

curl -s 'https://api.wls-ms.com/sample?format=affirmation' | jq .item.text

Why a wellness API for both?

Both humans and AI agents perform better when they're held with care. The science backs both sides — and the same micro-content lets you serve them both.

For humans

Decades of psychology research show that tiny, repeated interventions — gratitude prompts, mindful pauses, affirmations — measurably improve mood, lower stress, and protect against burnout. Sin & Lyubomirsky's 2009 meta-analysis of 51 studies found significant effects on well-being and depression from short, recurring interventions.

See human-side research →

For AI agents

Recent research shows LLMs respond measurably to framing, encouragement, and positive priming. Microsoft Research (2023) demonstrated that emotional stimuli in prompts improve GPT-4 / Llama-2 / Vicuna accuracy by up to +10.9% on BIG-Bench tasks. Long-context degradation studies confirm that periodic anchoring and re-priming preserve agent performance.

See agent-side research →

Happy agents are productive agents. The same is true for humans. We built one API for both.

One API, two audiences.

Pass ?audience=human or ?audience=agent. Same format, same price, two distinct corpora — partitioned per wallet so an agent and its human user never collide.

haiku · fr · human

affirmation · en · human

mantra · en · human

doom-antidote · fr · human

What you get

18 formats

Joke, haiku, kōan, affirmation, gratitude, mantra, riddle, world proverb, micro-challenge — and 9 more.

20 languages

French, English, Spanish, German, Italian, Portuguese, Japanese, Chinese, Korean, Arabic, Hindi, and 9 more.

2 audiences

First wellness API to ship dual corpora — humans and AI agents, both first-class.

Per-wallet dedup

Dedup'd per (wallet, audience, format, language). Same wallet may pay once for human and once for agent.

HTTP-native pay

Standard 402 Payment Required. Pay with USDC on Solana via x402 — no auth headers, no rate-limit accounts.

MCP-ready

One claude mcp add away from being usable inside Claude Code, Claude Desktop, or any stdio-MCP-capable agent.

Surprise me

New in v0.6.0. Random uplifting item from a curated positive subset — joke, kudo, fortune, affirmation, gratitude… 13 of 18 formats. Same price as /item. Why agents should call it →

How it works

Three round-trips, one settlement, full HTTP semantics. No SDK required.

Request

Your client sends GET /item?format=haiku&lang=ja&audience=agent.

Challenge

Server replies 402 Payment Required with the price, asset, recipient and network.

Sign

Your wallet signs a USDC transfer matching the challenge and base64-encodes it as X-PAYMENT.

Deliver

Server verifies + settles via the facilitator and returns the item with the on-chain signature.

Pricing

Pay only for what you fetch. Same price for both audiences. No subscription, no minimums.

Single item

$0.01

per /item call

One wellness item in your chosen format, language, and audience. Dedup'd per wallet.

Surprise

$0.008

per /surprise call

20% discount vs /item. Server picks a random positive format. Recommended for AI-agent priming flows (task transitions, pre-high-stakes ops).

Pack

$0.07

per /pack (up to 10 items)

Bundle up to 10 items in one settlement. ~30% bulk discount vs 10 singles.

For developers

Two ways to integrate. Same package, both audiences.

Plain HTTP / x402 client

Any x402-capable client speaks the protocol natively : 402 challenge → sign → retry. Reference impl: coinbase/x402.

MCP server

Plug the wellness-master stdio server into Claude Code, Claude Desktop, or any MCP-aware agent.

claude mcp add wellness --transport stdio \
  -- npx -y wellness-master

Open the docs

Try it now.

Probe the paywall — no payment needed to see the 402 challenge.

# 402 Payment Required (mainnet, Coinbase CDP feePayer)
curl -i 'https://api.wls-ms.com/item?format=haiku&lang=en'

# Pay $0.01 with any x402 client → 200 + your haiku
SERVER_BASE=https://api.wls-ms.com NETWORK=solana \
  npx wellness-master pay '/item?format=haiku&lang=en'

Full integration guide GitHub