> ## Documentation Index
> Fetch the complete documentation index at: https://ekacare-quickstart-cleanup.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:**

```text theme={null}
"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
```

<Note>
  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.
</Note>

## 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

```text theme={null}
"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

```text theme={null}
"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:

```json theme={null}
{
  "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?

<CardGroup cols={2}>
  <Card title="Introduction" icon="rocket" href="/ai-tools/mcp-server/introduction">
    Get started with Eka MCP
  </Card>

  <Card title="Authentication" icon="lock" href="/ai-tools/mcp-server/authentication">
    Setup authentication methods
  </Card>

  <Card title="Custom Client" icon="code" href="/ai-tools/mcp-server/integrations/custom-client">
    Build your own MCP client
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference/authorization/getting-started">
    Complete API documentation
  </Card>
</CardGroup>

***

**Questions?** Email [ekaconnect@eka.care](mailto:ekaconnect@eka.care)