Open Data Initiative

The Holistic Care Open Mindfulness API & MCP

Free, structured mindfulness resources for developers, educators, researchers and wellbeing applications, available as a REST API and as a Model Context Protocol (MCP) server for AI assistants and agents.

View on GitHub

What You Can Access

The API surfaces the same content that lives on this site, exposed as clean, structured JSON.

Public Article Records

Excerpt-level metadata for 500+ published articles: title, slug, summary, category and canonical URL.

Mindfulness Games

Structured records for all 16 browser-based mindfulness games, with age range, duration and skill tags.

Free Guided Practices

100+ free guided audio practices from the Stillness Library, with category, duration and direct audio links.

Research & Whitepaper Resources

A growing, curated set of peer-reviewed research summaries in plain language, with authors, year, study type and key findings.

Mindfulness Glossary

A growing, curated set of plain-language definitions covering mindfulness, yoga, meditation, Kundalini and nonduality terms.

Unified Resource Discovery & Search

A single endpoint that aggregates every resource family, plus full-text search across the whole catalog.

Who Can Use It

Developers

Build wellbeing features, chat assistants or content widgets on top of a free, structured API.

Educators & Schools

Pull age-appropriate mindfulness games and practices into classroom tools and portals.

Researchers & Students

Query a consistent, citable catalog of mindfulness and yoga research summaries.

Wellbeing Platforms

Extend an existing app or product with ready-made guided practices and articles.

AI & Agent Developers

Ground assistants and agents in structured, sourced mindfulness content rather than free text.

Example Use Cases

  • A classroom app that pulls a random mindfulness game matched to a student’s age
  • A meditation app widget that surfaces a relevant guided practice by category
  • A research assistant that cites peer-reviewed studies by topic
  • A chatbot that defines a yoga or nonduality term on request
  • A school portal listing this week’s recommended breathing exercise
  • A content aggregator indexing mindfulness articles with proper attribution
  • An AI agent that searches across articles, games and practices from one query

A Simple Example

One request, aggregated results across every resource family. This is not the full reference, just a taste of the shape of a response.

GET https://api.theholisticcare.com/v1/search?q=self-compassion%20break&limit=3

{
  "data": [
    {
      "id": "SL-015",
      "title": "A Gentle Self-Compassion Break: Free 10-Minute Practice",
      "slug": "gentle-self-compassion-break",
      "type": "guided_practice",
      "summary": "A free self-compassion practice for difficult moments...",
      "category": "mindfulness",
      "access": "free",
      "source_url": "https://www.theholisticcare.com/stillness-library/gentle-self-compassion-break",
      "updated_at": "2026-09-24T05:32:33Z"
    }
  ],
  "pagination": { "limit": 3, "offset": 0, "total": 1 }
}

For AI Assistants & Agents

Open Mindfulness MCP Server

The same public resources are also available through the Model Context Protocol, so AI assistants and agents can search and retrieve them directly. It sits on top of the REST API above: REST is for applications you build, MCP is for AI clients that connect to it.

Connection details

Remote MCP endpoint
https://mcp.theholisticcare.com/mcp
Transport
Streamable HTTP
Authentication
None required
Access
Public, read-only
Tools
7
Resources
5
Official MCP Registry
com.theholisticcare/open-mindfulness

What AI clients can do

  • Search across all public mindfulness resources
  • Retrieve a single resource by its identifier
  • Find mindfulness games by age, duration or skill
  • Find free guided practices from the Stillness Library
  • Search plain-language research summaries
  • Look up mindfulness, yoga and nonduality glossary concepts
  • Find public PanchaVikas framework resources

Example client configuration (check your MCP client's documentation for its exact format):

{
  "mcpServers": {
    "thc-open-mindfulness": {
      "url": "https://mcp.theholisticcare.com/mcp"
    }
  }
}

Why We Built This

Most of what we publish, articles, games, guided practices, glossary terms and research summaries, already lives openly on this site. The API exists to make that same content available in a consistent, machine-readable form: predictable fields, canonical source URLs back to theholisticcare.com, and free public read access with no signup required. We want it to be straightforward for a developer, a teacher, or a curious researcher to query what we have without scraping a webpage, and just as straightforward for an AI system to cite us accurately rather than paraphrase from an uncredited crawl. Access is intentionally read-only and scoped to content we have chosen to make public.

Content Rights & Access

Access is free, public and read-only

No API key or signup is required to read published resources. There is no write access.

The software is MIT licensed

The API's source code is open source under the MIT License. See the GitHub repository for details.

Content is not covered by that license

Text, audio and other content returned by the API is © The Holistic Care, all rights reserved, unless a specific resource explicitly states otherwise. The MIT License applies to the API software only, not to the content it serves.

Attribution is recommended

When you use a resource, please credit The Holistic Care and link back to its canonical source URL, included on every resource returned by the API.

Build With Structured Mindfulness Resources

Explore the REST endpoints, connect an AI client over MCP, or look at the source on GitHub.