Supported Tools

Complete list of available MCP tools and their capabilities

Supported Tools

Eka MCP provides 20+ tools across patient management, appointments, ABHA/ABDM, and clinic operations. All tools support natural language queries through your AI assistant.

Patient Management

Tool Name	Description	Input Parameters	Returns
search_patients	Search for patients by name, mobile, email, or patient ID	query (string), limit (optional)	List of matching patients with IDs, contact info, and basic details
get_patient_details	Retrieve complete patient information	patient_id (string)	Full patient profile including medical history, demographics, and appointments
add_patient	Register a new patient	name, mobile, email (optional), dob (optional), gender (optional)	New patient ID and confirmation
update_patient	Modify existing patient information	patient_id, fields to update	Updated patient details

Appointment Management

Tool Name	Description	Input Parameters	Returns
get_available_slots	Check doctor’s availability	doctor_id, date, clinic_id (optional)	List of available time slots
book_appointment	Schedule a new appointment	patient_id, doctor_id, slot_time, clinic_id	Appointment ID and confirmation
get_appointments	List appointments by various filters	patient_id OR doctor_id OR date, status (optional)	List of appointments with details
reschedule_appointment	Change appointment timing	appointment_id, new_slot_time	Updated appointment details
cancel_appointment	Cancel scheduled appointment	appointment_id, reason (optional)	Cancellation confirmation
get_appointment_details	Retrieve specific appointment info	appointment_id	Complete appointment information

ABHA / ABDM

ABHA (Ayushman Bharat Health Account) tools let your AI assistant help patients log in with their ABHA mobile number, select their health profile, and fetch their ABHA card — all through a guided multi-step flow.

Tool Name	Description	Input Parameters	Returns
abha_send_otp	Step 1 — Send OTP to the patient’s ABHA-registered mobile number	mobile_number (10-digit)	txn_id to pass to the next step
abha_verify_otp	Step 2 — Verify the OTP entered by the patient	otp, txn_id (from Step 1)	Either the completed ABHA profile + card, or a list of profiles to choose from
abha_select_profile	Step 3 (if needed) — Select an ABHA profile when the patient has multiple	phr_address (e.g. user@abdm), txn_id (from Step 2)	Completed ABHA profile + ABHA card (base64 PNG)

Typical flow:

"Help me log in with my ABHA"
→ abha_send_otp          (OTP sent to mobile)
→ abha_verify_otp        (OTP verified — returns profile or profile list)
→ abha_select_profile    (only if multiple profiles exist)
→ ABHA card shown to user

ABHA card is returned as a base64-encoded PNG in the response. The AI will render and display it directly — no additional tool call is needed.

Doctor & Clinic Operations

Tool Name	Description	Input Parameters	Returns
get_doctor_profile	Access doctor information	doctor_id	Doctor details, qualifications, specializations
search_doctors	Find doctors by name or specialization	query, specialization (optional)	List of matching doctors
get_clinic_details	Retrieve clinic information	clinic_id	Clinic address, services, contact info
get_doctor_clinics	List clinics associated with doctor	doctor_id	Array of clinic details
get_clinic_services	View services offered by clinic	clinic_id	List of available services

Medication Database

Tool Name	Description	Input Parameters	Returns
search_medications	Look up medicine information	query (drug name)	Medicine details, dosage forms, manufacturers
get_medication_details	Get complete drug information	medication_id	Full drug profile with interactions and contraindications

Tool Parameters

Usage Examples

Simple Queries

"Search for patient Raj Kumar"
→ Uses: search_patients

"Show Dr. Singh's available slots tomorrow"
→ Uses: get_available_slots

"Get prescription history for patient 12345"
→ Uses: get_prescriptions

Complex Workflows

"Book appointment for Raj Kumar with Dr. Singh tomorrow at 10 AM
and create prescription for Amoxicillin"
→ Uses: search_patients → book_appointment → create_prescription

Rate Limits

Plan	Requests/Minute	Requests/Day
Free	10	1,000
Pro	60	10,000
Enterprise	Unlimited	Unlimited

Error Handling

All tools return standardized error responses:

{
  "error": true,
  "message": "Patient not found",
  "code": "PATIENT_NOT_FOUND"
}

Common Error Codes

• PATIENT_NOT_FOUND - Patient ID doesn’t exist
• SLOT_UNAVAILABLE - Appointment slot already booked
• INVALID_PARAMETERS - Missing or incorrect parameters
• UNAUTHORIZED - Authentication required
• RATE_LIMIT_EXCEEDED - Too many requests

Need More Details?

Introduction

Get started with Eka MCP

Authentication

Setup authentication methods

Custom Client

Build your own MCP client

API Reference

Complete API documentation

---

Questions? Email [e-mail]