# Truepill MCP for AI Agents AI Agent Connect

> Truepill MCP lets you manage pharmacy operations and patient records through your AI agent. Create new patient profiles, search records by demographics like zip code or DOB, and track prescription statuses without switching tabs. It gives your agent direct access to prescription histories and real-time order updates.

## Overview
- **Category:** data-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ZaoS2g2PzJDp9bK9qWwn3RoAtuP0yHTfSnZn72WC/ai-agent-connect
- **Tags:** pharmacy-api, patient-records, prescription-management, healthcare-it, telehealth

## Description

Managing a pharmacy involves jumping between different screens to find a patient's history or check if a shipment actually moved. This Connector changes that by letting your AI agent handle the heavy lifting of data retrieval and record updates directly. Instead of hunting for a patient's token or scrolling through a messy dashboard, you can just ask your agent to find a specific person or pull up their last three prescriptions. It handles the boring stuff like updating contact info or pulling NDC details so you can focus on the actual work of patient care. Whether you're looking for a specific refill count or trying to catch up on order statuses via webhooks, this connection makes the data you need available in one place. This is a big part of why Vinkius is the go-to for these kinds of integrations, giving you a single connection to over 4,000 Connectors from any AI client. You get a conversational way to manage the entire lifecycle of a prescription, from the moment a patient is created to the final shipment notification. It removes the need to keep multiple tabs open or copy data from one system to another, ensuring your records stay accurate and your team stays efficient.

## Tools

### find_patient
Search for patients using demographics like name, DOB, or zip code. You don't need to know their ID beforehand.

### get_patient_prescriptions
List every prescription tied to a specific patient. This gives you a full view of their treatment history.

### get_webhook_events
Get notified about order, shipment, or transfer events. It keeps you updated on the pharmacy lifecycle automatically.

### update_patient
Change a patient's phone, email, or address. It's the quickest way to keep contact records current.

### create_patient
Register a new patient in the system. It returns a unique token for all future interactions.

### get_patient
Pull up a specific patient's full profile using their unique token. Use this when you already know who you're looking for.

### get_prescription
Get the exact details for a single prescription. It includes things like the prescriber details and refill counts.

## Prompt Examples

**Prompt:** 
```
Find a patient named Alice Smith born on 19880425.
```

**Response:** 
```
I've searched the records and found a match for Alice Smith.

**Patient Details:**
- **Name:** Alice Smith
- **DOB:** 1988-04-25
- **Token:** `pt_987654321` 

Would you like to see her full profile?
```

**Prompt:** 
```
Get all prescriptions for patient pt_987654321.
```

**Response:** 
```
I've pulled the prescription history for patient `pt_987654321`. Here is what I found:

| Medication | Status |
| :--- | :--- |
| **Amoxicillin** | Filled |
| **Lisinopril** | Pending |

Do you need the specific details for either of these?
```

**Prompt:** 
```
Create a new patient record for Bob Jones, male, born 19751212, living in New York 10001.
```

**Response:** 
```
I've successfully created the record for Bob Jones.

**New Patient Profile:**
- **Name:** Bob Jones
- **Gender:** Male
- **DOB:** 1975-12-12
- **Location:** New York 10001
- **Patient Token:** `pt_112233445` 

You can now start adding prescriptions to this profile.
```

## Capabilities

### Create new patient records
Register a new patient in the system and receive a unique token for future lookups.

### Search for patients by name or zip code
Locate patient profiles using common demographics without needing to know a specific ID first.

### Pull full prescription histories
Retrieve every prescription tied to a specific patient for a complete treatment overview.

### Update patient contact information
Modify phone numbers, emails, and addresses to keep patient records current.

### Monitor real-time order and shipment webhooks
Get instant updates on pharmacy lifecycle changes and order statuses as they happen.

### Fetch specific prescription metadata
Access precise details like NDC codes, prescriber info, and refill counts.

## Use Cases

### Quickly pulling up history during a call
A provider needs a patient's history during a phone call. They ask the agent to find the patient and pull up all prescriptions using find_patient and get_patient_prescriptions.

### Tracking a delayed shipment
A pharmacy team is confused about a late order. They ask the agent to check the latest status via get_webhook_events to see the exact shipment location.

### Updating contact info on the fly
A patient changes their phone number during a conversation. The staff uses update_patient to sync the new number immediately without opening a new tab.

### Onboarding a new patient
A new patient walks in and needs a record set up. The staff uses create_patient to generate a profile and get a unique token instantly.

## Benefits

- No more manual searching: Use find_patient to locate records by zip code or name instantly.
- Faster updates: Use update_patient to change contact info without leaving your chat window.
- Complete history: Pull every past prescription using get_patient_prescriptions to see a full treatment timeline.
- Real-time tracking: Stay on top of shipments and orders with get_webhook_events.
- Detailed data: Get specific NDC and refill counts with get_prescription for precise medication management.

## How It Works

The bottom line is you get a conversational interface for your pharmacy's entire patient and prescription database.

1. Subscribe to the Truepill MCP on Vinkius.
2. Input your Truepill API Key into your AI client settings.
3. Ask your agent to find a patient, update a record, or check a prescription status.

## Frequently Asked Questions

**Can Truepill MCP help me find patients by zip code?**
Yes, you can ask your agent to search for patients using demographics like zip code, name, or date of birth. This allows you to find records quickly without needing to know a specific patient token first.

**Does Truepill MCP track pharmacy shipments?**
Yes, it connects to order and shipment webhooks. Your agent can check the status of shipments and other pharmacy lifecycle events in real time.

**Can I update patient phone numbers with Truepill MCP?**
You can update contact information like phone numbers, emails, and addresses. Your agent can handle these updates directly through natural conversation.

**Does Truepill MCP show prescription refill counts?**
Yes, the Connector can pull specific prescription metadata, including NDC codes and refill counts, giving you a detailed view of a patient's medication.

**Is Truepill MCP good for telehealth providers?**
It is excellent for telehealth. Providers can use it to quickly pull up prescription histories and patient records during consultations without leaving their chat interface.

**How do I see prescription history using Truepill MCP?**
You can simply ask your agent to list all prescriptions for a specific patient. It will retrieve the full history and present it to you in a clear format.

**Can Truepill MCP handle new patient registrations?**
Yes, your agent can create new patient records for you. It will register the information and provide you with a unique patient token for future use.

**Can I search for a patient without having their specific patient token?**
Yes. You can use the `find_patient` tool to search by first name, last name, date of birth, or zip code to locate the correct record.

**How do I check the status of all medications assigned to a patient?**
Use the `get_patient_prescriptions` tool with the patient's token. It will return a list of all prescriptions, their current status, and whether they are fillable.

**Is it possible to update a patient's date of birth if it was entered incorrectly?**
No. The `update_patient` tool only allows modifications to non-required fields like address, phone, and email. Required identity fields like DOB cannot be changed via this tool.