Health
Data source: Curated dataset (CMS, AHA)
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/hospital-directory/
claude_desktop_config.json
{
"mcpServers": {
"gnist-hospital-directory": {
"url": "https://context.gnist.ai/mcp/hospital-directory/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/hospital-directory/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_hospital", "arguments": {"hospital_id": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/hospital-directory/
10 endpoints available:
GET /rest/hospital-directory/get_hospitalGET /rest/hospital-directory/search_hospitalsGET /rest/hospital-directory/list_hospitals_by_stateGET /rest/hospital-directory/list_hospitals_by_typeGET /rest/hospital-directory/list_hospitals_by_specialtyGET /rest/hospital-directory/list_trauma_centersGET /rest/hospital-directory/get_hospital_statesGET /rest/hospital-directory/get_hospital_typesGET /rest/hospital-directory/get_medical_specialtiesGET /rest/hospital-directory/report_feedback
Shell
curl "https://context.gnist.ai/rest/hospital-directory/get_hospital?hospital_id=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/hospital-directory/get_hospital",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"hospital_id": "example"
},
)
print(resp.json())
Command Line
Command
gc hospital-directory
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (10)
get_hospitalGet detailed information about a hospital.
| Parameter | Type | Required | Description |
|---|---|---|---|
hospital_id | string | required | Hospital ID slug (e.g. mayo-clinic-rochester, johns-hopkins). |
search_hospitalsSearch the hospital directory.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search by name, city, or specialty. |
limit | integer | optional | (default: 20) |
list_hospitals_by_stateList hospitals in a US state.
| Parameter | Type | Required | Description |
|---|---|---|---|
state | string | required | US state abbreviation (e.g. MA, CA, NY). |
limit | integer | optional | (default: 50) |
list_hospitals_by_typeList hospitals by type.
| Parameter | Type | Required | Description |
|---|---|---|---|
hospital_type | string | required | Hospital type (Teaching, General, Children's, VA). |
limit | integer | optional | (default: 50) |
list_hospitals_by_specialtyList hospitals with a given medical specialty.
| Parameter | Type | Required | Description |
|---|---|---|---|
specialty | string | required | Medical specialty (e.g. Cardiology, Oncology, Neurology). |
limit | integer | optional | (default: 50) |
list_trauma_centersList trauma centers by level.
| Parameter | Type | Required | Description |
|---|---|---|---|
level | string | optional | (default: "Level I") |
limit | integer | optional | (default: 50) |
get_hospital_statesList all US states with hospitals in the directory.
get_hospital_typesList all hospital types in the directory.
get_medical_specialtiesList all medical specialties in the directory.
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |