How to Use the Health Gorilla MCP in Mastra AI

Q: How do I get started with the Health Gorilla MCP Server and Mastra AI?

Install the @mastra/mcp package and create a new MCPClient instance with your Vinkius server URL. You can then get the list of tools with mcpClient.listTools() and spread them into your Mastra agent's tool configuration.

Q: Can a Mastra AI agent prevent duplicate patient records in Health Gorilla?

Yes. You design a workflow where the agent first calls matchpatient. Using conditional logic, the agent can decide whether to proceed with an existing patient ID or call createpatientrecord to register a new one.

Build resilient clinical workflows that automate patient intake and lab ordering with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Health Gorilla MCP to Mastra AI

Create your Vinkius account to connect Health Gorilla to Mastra AI 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 Health Gorilla with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Patient Registration Workflows

Stop writing brittle `if/else` blocks for patient intake. A Mastra AI workflow can first call `match_patient` to check for existing records. If the match score is low, the workflow's conditional logic automatically branches to the `create_patient_record` tool. This isn't just about control flow. If the Health Gorilla API has a hiccup, Mastra’s built-in retry mechanism handles the failure. Your workflow simply pauses and retries, picking up right where it left off without you writing a single line of error-handling code.

Create Unbreakable Lab Ordering Pipelines

A lab order is a multi-step process, which is exactly what Mastra AI workflows are built for. The agent can start by using `search_lab_tests` to find the correct test code, then `submit_lab_order` to place the order. Here's the critical part: you can enforce a human-in-the-loop step using Mastra's `requireToolApproval` function right before the `submit_lab_order` call. The workflow pauses for confirmation, then proceeds. After submission, it can poll `get_order_status` until the test is complete, surviving any network issues along the way. That's what reliable automation looks like.

Process Lab Results Without Dropping Data

Don't risk losing a critical lab result because a downstream system is offline. You can build a Mastra AI agent that periodically checks for new results using `list_patient_results`. When a new result appears, the workflow triggers a call to `get_lab_results` to fetch the details. The agent then attempts to post that data to your EHR. If that system is down and returns an error, Mastra's exponential backoff kicks in, retrying the operation later. This guarantees the result is eventually processed, preventing data loss. This MCP server gives you the data; Mastra makes sure it gets where it needs to go.

Setup guide

Set up Health Gorilla MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Health Gorilla tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "health-gorilla-mcp-client",
  servers: {
    "health-gorilla-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Health Gorilla Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Health Gorilla tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Health Gorilla transactions"
);
console.log(result.text);

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 Health Gorilla. 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 Health Gorilla 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 Health Gorilla MCP in Mastra AI

Install the `@mastra/mcp` package and create a new `MCPClient` instance with your Vinkius server URL. You can then get the list of tools with `mcpClient.listTools()` and spread them into your Mastra agent's tool configuration.

Yes. You design a workflow where the agent first calls `match_patient`. Using conditional logic, the agent can decide whether to proceed with an existing patient ID or call `create_patient_record` to register a new one.

Mastra's workflow engine has automatic retries with exponential backoff. If a call to `submit_lab_order` fails because of a temporary network issue, the agent will automatically try again. You don't have to write any of the retry logic yourself.

Yes, this is a core Mastra feature. When defining the tools for your agent, use the `requireToolApproval` option on the `submit_lab_order` tool. The workflow will pause at that step and wait for a human to approve the action before executing it.

The workflow processes patient demographic data, lab orders, and test results. Your connection to the MCP server is sandboxed and ephemeral on Vinkius. Mastra AI orchestrates the API calls, but the sensitive clinical data is not stored by Mastra or Vinkius.

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