How to Use the Wellhub MCP in LlamaIndex

Q: How does Wellhub assist in multi-step validation using LlamaIndex?

When validatecheckin runs, the results are indexed. Later queries can ask for 'the eligibility result of a check-in at location X,' retrieving precise historical data and confirmation details.

Q: Can I use LlamaIndex to understand available classes across multiple locations?

Yes. You index the outputs from listlocations and then link those records to class schedules pulled via listclasses. This creates a searchable map of availability that goes far beyond simple API calls.

Q: If I need to know about partner details, how does Wellhub work with LlamaIndex?

The getpartnerinfo tool output can be indexed and queried by name or type. This lets your application answer complex questions like: 'What are the key details for our main corporate partner?'

Index Wellhub data into vector stores for semantic search with LlamaIndex.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Wellhub MCP to LlamaIndex

Create your Vinkius account to connect Wellhub to LlamaIndex and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Wellhub with LlamaIndex

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Creating a Knowledge Base of Wellness Rules with MCP Server

Use `check_eligibility` to fetch plan tier and access permissions, then index this data. You can build an RAG system that answers complex questions like: 'Does Plan X allow entry at Location Y?' without hallucination. The indexed records of successful calls to `get_partner_info` become part of your knowledge base, allowing the agent to reference specific partner details during retrieval.

Querying Past Booking and Class Data with LlamaIndex

Instead of just calling `list_bookings`, you index these results. This means you can query past sessions semantically, asking: 'What was the status of Jane Doe's booking last Tuesday?' The answer comes grounded in the actual API data. The same principle applies to class schedules; indexing `list_classes` lets users search for classes based on intent ('a low-impact session') rather than just a fixed name.

Analyzing Utilization Patterns with LlamaIndex

Indexing `list_check_ins` allows you to build sophisticated reporting. You can query past check-in logs, asking for 'all visits using the Bronze plan in Q3.' The system retrieves and grounds this answer directly from recorded date/time stamps. The results of calling `list_eligible_employees` are stored alongside historical data, letting users compare current membership rules against old utilization reports.

Setup guide

Set up Wellhub MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all Wellhub MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to Wellhub tools.",
)
response = await agent.run("List recent Wellhub data")

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Wellhub. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Wellhub now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Wellhub MCP in LlamaIndex

When `validate_check_in` runs, the results are indexed. Later queries can ask for 'the eligibility result of a check-in at location X,' retrieving precise historical data and confirmation details.

Yes. You index the outputs from `list_locations` and then link those records to class schedules pulled via `list_classes`. This creates a searchable map of availability that goes far beyond simple API calls.

You can query employee plan tiers, specific booking statuses (class name, member name), and detailed facility check-in logs. The server exposes the core corporate wellness program data.

The `get_partner_info` tool output can be indexed and queried by name or type. This lets your application answer complex questions like: 'What are the key details for our main corporate partner?'

This MCP Server touches employee plan tier and usage status. Specifically, `list_eligible_employees` provides access to a user's plan tier and activation date.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript