Health

Data source: Curated dataset (CMS, AHA)

MCP Endpoint (Streamable HTTP) https://context.gnist.ai/mcp/hospital-directory/

Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (10)

get_hospital
search_hospitals
list_hospitals_by_state
list_hospitals_by_type
list_hospitals_by_specialty
list_trauma_centers
get_hospital_states
get_hospital_types
get_medical_specialties
report_feedback

get_hospital

Get detailed information about a hospital.

Returns name, location, type, beds, trauma level, specialties, and accreditation.

Parameter	Type	Required	Description
`hospital_id`	`string`	required	Hospital ID slug (e.g. mayo-clinic-rochester, johns-hopkins).

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_hospital",
    "arguments": {
      "hospital_id": "example"
    }
  }
}

search_hospitals

Search the hospital directory.

Parameter	Type	Required	Description
`query`	`string`	required	Search by name, city, or specialty.
`limit`	`integer`	optional	(default: 20)

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_hospitals",
    "arguments": {
      "query": "example"
    }
  }
}

list_hospitals_by_state

List 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)

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "list_hospitals_by_state",
    "arguments": {
      "state": "example"
    }
  }
}

list_hospitals_by_type

List hospitals by type.

Parameter	Type	Required	Description
`hospital_type`	`string`	required	Hospital type (Teaching, General, Children's, VA).
`limit`	`integer`	optional	(default: 50)

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "list_hospitals_by_type",
    "arguments": {
      "hospital_type": "example"
    }
  }
}

list_hospitals_by_specialty

List 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)

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "list_hospitals_by_specialty",
    "arguments": {
      "specialty": "example"
    }
  }
}

list_trauma_centers

List trauma centers by level.

Parameter	Type	Required	Description
`level`	`string`	optional	(default: "Level I")
`limit`	`integer`	optional	(default: 50)

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "list_trauma_centers",
    "arguments": {}
  }
}

get_hospital_states

List all US states with hospitals in the directory.

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_hospital_states",
    "arguments": {}
  }
}

get_hospital_types

List all hospital types in the directory.

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_hospital_types",
    "arguments": {}
  }
}

get_medical_specialties

List all medical specialties in the directory.

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_medical_specialties",
    "arguments": {}
  }
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "report_feedback",
    "arguments": {
      "feedback": "example"
    }
  }
}

Quick Start

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"}}}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/hospital-directory/",
    headers={"Gnist-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_hospital",
    "arguments": {
      "hospital_id": "example"
    }
  }
},
)
print(resp.json())