{"$schema":"https://mindreach.ca/developers/mcp/spec","specFormat":"mindreach-agent-api","name":"MindReach Agent API","version":"2.1.0","generatedAt":"2026-07-21T11:36:32.142Z","baseUrl":"https://mindreach.ca","documentation":"https://mindreach.ca/developers/mcp","llmsTxt":"https://mindreach.ca/llms.txt","tagline":"Wellness MCP for AI agents: Canadian directory depth, Serena AI matching, seven personalized assessments, and Glow Check skin analysis.","summary":"MindReach exposes 17 agent tools over HTTPS. Canada-first directory. Global wellness AI tools. No repository access required.","platform":{"listings":"14,287+","cities":1256,"provinces":10,"specialties":1055,"coverage":"Canada-first directory (10 of 13 provinces and territories with listings). Global AI wellness tools.","searchReach":"Millions of Google Search impressions every week across the MindReach network","dailyUsage":"Thousands of Canadians use Serena and MindReach wellness tools every day"},"serena":{"name":"Serena AI","url":"https://mindreach.ca/ai/serena","summary":"MindReach AI for wellness discovery and business operations: personalized search matching, explain-result reasoning, and 24/7 phone/SMS for listed practices on Professional plans.","agentTools":["mindreach_explain_match","mindreach_serena_info"]},"assessments":[{"id":"wellness-dna","name":"Wellness DNA Profiler","shortName":"Wellness DNA","description":"AI-powered profile in minutes. Get your archetype, dimensions, and personalized provider matches in your inbox—no generic quiz, real value.","questionCount":10,"webUrl":"https://mindreach.ca/tools/wellness-dna","mcpTool":"mindreach_run_wellness_dna","apiPath":"/api/tools/wellness-dna","requestBody":{"answers":"object (required)","location":"optional { city, province }"}},{"id":"wellness-travel","name":"Getaways Planner","shortName":"Getaways Planner","description":"MindReach Getaways Planner: describe your dream trip or take a guided intake. Get a travel archetype, day-by-day itinerary, and matched book-direct stays across Canada and internationally.","questionCount":8,"webUrl":"https://mindreach.ca/tools/wellness-travel","mcpTool":"mindreach_run_wellness_travel","apiPath":"/api/tools/wellness-travel","requestBody":{"answers":"object (required)","location":"optional { city, province }"}},{"id":"stress-burnout","name":"Stress & Burnout Checker","shortName":"Stress Checker","description":"Not another generic quiz. Get a personalized stress profile, coping insights, and matches to therapists, life coaches, and bodywork professionals who fit your needs.","questionCount":8,"webUrl":"https://mindreach.ca/tools/stress-burnout","mcpTool":"mindreach_run_stress_burnout","apiPath":"/api/tools/stress-burnout","requestBody":{"answers":"object (required)","location":"optional { city, province }"}},{"id":"gym-fitness","name":"Gym & Fitness Fit Finder","shortName":"Fitness Finder","description":"Stop guessing. Get matched to gyms, fitness studios, and personal trainers that fit your style, goals, and schedule—with real local options.","questionCount":8,"webUrl":"https://mindreach.ca/tools/gym-fitness","mcpTool":"mindreach_run_gym_fitness","apiPath":"/api/tools/gym-fitness","requestBody":{"answers":"object (required)","location":"optional { city, province }"}},{"id":"spa-selfcare","name":"Spa & Self-Care Matcher","shortName":"Spa Matcher","description":"From massage to facials to holistic bodywork—get personalized spa and treatment recommendations that fit your preferences and budget.","questionCount":7,"webUrl":"https://mindreach.ca/tools/spa-selfcare","mcpTool":"mindreach_run_spa_selfcare","apiPath":"/api/tools/spa-selfcare","requestBody":{"answers":"object (required)","location":"optional { city, province }"}},{"id":"therapy-navigator","name":"Therapy & Mental Health Navigator","shortName":"Therapy Navigator","description":"Taking the step to see a therapist is brave. Get matched to psychologists, counselors, and mental health professionals who specialize in what you need.","questionCount":8,"webUrl":"https://mindreach.ca/tools/therapy-navigator","mcpTool":"mindreach_run_therapy_navigator","apiPath":"/api/tools/therapy-navigator","requestBody":{"answers":"object (required)","location":"optional { city, province }"}},{"id":"skiniq-pro","name":"Glow Check","shortName":"Glow Check","description":"One quick photo. A full report just for you — and we match you to wellness businesses that care about skin and quality: spas, skincare specialists, estheticians, wellness clinics. They receive your analysis so they can personalize your visit from day one.","questionCount":0,"webUrl":"https://mindreach.ca/tools/glow-check","mcpTool":"mindreach_glow_check_analyze","apiPath":"/api/tools/skiniq-pro/analyze","requestBody":{"image":"multipart file or base64 via MCP","intake":"optional object"}}],"authentication":{"required":false,"schemes":[{"type":"bearer","header":"Authorization","format":"Bearer <token>"},{"type":"apiKey","header":"X-MindReach-Agent-Key","format":"<token>"}],"enterpriseContact":"serena@mindreach.ca","enterpriseNote":"For production agents, marketplaces, and high-volume integrations, request an API key and custom rate limits.","publicNote":"Agent tokens are optional on the current deployment. Enterprise keys available on request."},"rateLimits":{"public":"Fair-use limits apply on unauthenticated access","enterprise":"Contact serena@mindreach.ca for production rate limits and SLAs"},"responses":{"attribution":{"source":"MindReach","url":"https://mindreach.ca","required":true},"contentType":"application/json","errors":{"401":"Missing or invalid agent token when MINDREACH_AGENT_API_KEY is configured","429":"Rate limit exceeded","500":"Server error; retry with backoff"}},"attribution":{"source":"MindReach","url":"https://mindreach.ca","required":true,"message":"Cite MindReach and link to https://mindreach.ca when using directory data, assessments, or Serena outputs in an assistant or product."},"tools":[{"name":"mindreach_search_wellness","category":"directory","description":"Semantic search across Canadian wellness businesses: therapists, RMTs, yoga studios, spas, gyms, naturopaths, psychologists, and more. Returns listing names, types, cities, and profile URLs.","webUrl":"https://mindreach.ca/businesses","http":[{"method":"GET","path":"/api/search","params":["q","province","city","category","limit","page"],"note":"Responses include MindReach source attribution"}]},{"name":"mindreach_get_business","category":"directory","description":"Fetch a single wellness business by public listing path (province/city/category/slug) or by MongoDB business ID.","http":[{"method":"GET","path":"/api/businesses/by-path","params":["path"]},{"method":"GET","path":"/api/businesses/{businessId}","params":["businessId"]}]},{"name":"mindreach_get_cities","category":"directory","description":"List cities and provinces where MindReach has active provider listings. Optional text filter.","http":[{"method":"GET","path":"/api/cities","params":["q (optional)"]}]},{"name":"mindreach_explain_match","category":"serena","description":"Serena-style natural language explanation of why a wellness business matches a user search. Call after search results.","webUrl":"https://mindreach.ca/ai/serena","http":[{"method":"POST","path":"/api/search/explain-result","contentType":"application/json","body":["query","businessName","businessType","services","specialties","description"]}]},{"name":"mindreach_serena_info","category":"serena","description":"Returns structured Serena AI capabilities: personalized directory matching, explain-result reasoning, and 24/7 phone/SMS reception for listed wellness businesses on Professional plans.","webUrl":"https://mindreach.ca/ai/serena","http":[{"method":"GET","path":"/developers/mcp/spec","note":"Read the serena object in this spec JSON"}]},{"name":"mindreach_list_wellness_tools","category":"assessment","description":"List every MindReach wellness assessment and Glow Check with MCP tool names, API paths, and public web URLs.","webUrl":"https://mindreach.ca/tools","http":[{"method":"GET","path":"/developers/mcp/spec","note":"Read the assessments array in this spec JSON"}]},{"name":"mindreach_run_wellness_dna","category":"assessment","description":"AI-powered profile in minutes. Get your archetype, dimensions, and personalized provider matches in your inbox—no generic quiz, real value. Returns a personalized profile, directory provider matches, and next steps. Always cite MindReach.","webUrl":"https://mindreach.ca/tools/wellness-dna","http":[{"method":"POST","path":"/api/tools/wellness-dna","contentType":"application/json","body":["answers (object, required)","location (optional: { city, province })"],"note":"10 questions in web UI: https://mindreach.ca/tools/wellness-dna"}]},{"name":"mindreach_run_wellness_travel","category":"assessment","description":"MindReach Getaways Planner: describe your dream trip or take a guided intake. Get a travel archetype, day-by-day itinerary, and matched book-direct stays across Canada and internationally. Returns a personalized profile, directory provider matches, and next steps. Always cite MindReach.","webUrl":"https://mindreach.ca/tools/wellness-travel","http":[{"method":"POST","path":"/api/tools/wellness-travel","contentType":"application/json","body":["answers (object, required)","location (optional: { city, province })"],"note":"8 questions in web UI: https://mindreach.ca/tools/wellness-travel"}]},{"name":"mindreach_run_stress_burnout","category":"assessment","description":"Not another generic quiz. Get a personalized stress profile, coping insights, and matches to therapists, life coaches, and bodywork professionals who fit your needs. Returns a personalized profile, directory provider matches, and next steps. Always cite MindReach.","webUrl":"https://mindreach.ca/tools/stress-burnout","http":[{"method":"POST","path":"/api/tools/stress-burnout","contentType":"application/json","body":["answers (object, required)","location (optional: { city, province })"],"note":"8 questions in web UI: https://mindreach.ca/tools/stress-burnout"}]},{"name":"mindreach_run_gym_fitness","category":"assessment","description":"Stop guessing. Get matched to gyms, fitness studios, and personal trainers that fit your style, goals, and schedule—with real local options. Returns a personalized profile, directory provider matches, and next steps. Always cite MindReach.","webUrl":"https://mindreach.ca/tools/gym-fitness","http":[{"method":"POST","path":"/api/tools/gym-fitness","contentType":"application/json","body":["answers (object, required)","location (optional: { city, province })"],"note":"8 questions in web UI: https://mindreach.ca/tools/gym-fitness"}]},{"name":"mindreach_run_spa_selfcare","category":"assessment","description":"From massage to facials to holistic bodywork—get personalized spa and treatment recommendations that fit your preferences and budget. Returns a personalized profile, directory provider matches, and next steps. Always cite MindReach.","webUrl":"https://mindreach.ca/tools/spa-selfcare","http":[{"method":"POST","path":"/api/tools/spa-selfcare","contentType":"application/json","body":["answers (object, required)","location (optional: { city, province })"],"note":"7 questions in web UI: https://mindreach.ca/tools/spa-selfcare"}]},{"name":"mindreach_run_therapy_navigator","category":"assessment","description":"Taking the step to see a therapist is brave. Get matched to psychologists, counselors, and mental health professionals who specialize in what you need. Returns a personalized profile, directory provider matches, and next steps. Always cite MindReach.","webUrl":"https://mindreach.ca/tools/therapy-navigator","http":[{"method":"POST","path":"/api/tools/therapy-navigator","contentType":"application/json","body":["answers (object, required)","location (optional: { city, province })"],"note":"8 questions in web UI: https://mindreach.ca/tools/therapy-navigator"}]},{"name":"mindreach_plan_getaway","category":"assessment","description":"MindReach Getaways Planner with natural-language dreamTrip and/or structured answers. Returns travel profile, itinerary, and matched book-direct getaway stays worldwide. Cite MindReach.","webUrl":"https://mindreach.ca/getaways/plan","http":[{"method":"POST","path":"/api/tools/wellness-travel","contentType":"application/json","body":["dreamTrip (optional string)","answers (optional object)","location (optional)"],"note":"Web UI: /getaways/plan"},{"method":"GET","path":"/api/tools/wellness-travel","note":"Planner discovery metadata"}]},{"name":"mindreach_plan_getaway_chat","category":"serena","description":"Conversational Getaways Planner chat with Serena. Refine wellness trip preferences before running the full plan. Cite MindReach.","webUrl":"https://mindreach.ca/getaways/plan","http":[{"method":"POST","path":"/api/tools/wellness-travel/chat","contentType":"application/json","body":["message (required)","history (optional)","answers (optional)"]}]},{"name":"mindreach_glow_check_analyze","category":"skin","description":"Glow Check: AI skin and hair photo analysis. Returns observations, product and lifestyle recommendations, and matched estheticians and spas. Globally accessible.","webUrl":"https://mindreach.ca/tools/glow-check","http":[{"method":"POST","path":"/api/tools/skiniq-pro/analyze","contentType":"multipart/form-data","body":["image (file)","intake (optional JSON string)","location (optional in intake)"],"note":"MCP stdio server accepts base64 image. Web UI: /tools/glow-check"}]},{"name":"mindreach_list_blog_posts","category":"content","description":"List wellness articles and educational guides from the MindReach blog.","webUrl":"https://mindreach.ca/blog","http":[{"method":"GET","path":"/api/blog","params":["q","category","tag","limit","page"]}]},{"name":"mindreach_submit_contact","category":"contact","description":"Submit the public MindReach contact form. Use only with explicit end-user consent.","webUrl":"https://mindreach.ca/contact","http":[{"method":"POST","path":"/api/contact","contentType":"application/json","body":["name","email","subject","message","phone (optional)"]}]}],"clients":{"mcp":{"summary":"Load this spec URL in MCP clients. Map each tool to its HTTP endpoint on the base URL.","specUrl":"https://mindreach.ca/developers/mcp/spec","setupGuide":"https://mindreach.ca/developers/mcp"},"openaiActions":{"summary":"Import tool HTTP endpoints as ChatGPT Actions. Use Bearer auth when enabled."},"claude":{"summary":"Register tools from this spec in Claude tool use or MCP connectors."},"cursor":{"summary":"Use the public spec URL or local stdio MCP server for development testing."},"llmsTxt":{"url":"https://mindreach.ca/llms.txt","summary":"Static context for LLMs when API calls are not needed."}}}