GnistAI GnistAI
Log in

Hospital Directory

US hospital directory — beds, trauma level, specialties, accreditation for major hospitals.

Overview   |   MCP Docs   |   API Docs   |   OpenAPI   |   Playground   |   Tutorial   |   Toolkits   |   Home
status: healthy status status healthy healthy tools: 10 tools tools 10 10 Health

Data source: Curated dataset (CMS, AHA)

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

API REST API

API Root https://context.gnist.ai/rest/hospital-directory/

10 endpoints available:

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

OpenAPI Spec  ·  Full API Docs

CLI 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_hospital
Get detailed information about a hospital.
ParameterTypeRequiredDescription
hospital_idstringrequiredHospital ID slug (e.g. mayo-clinic-rochester, johns-hopkins).
search_hospitals
Search the hospital directory.
ParameterTypeRequiredDescription
querystringrequiredSearch by name, city, or specialty.
limitintegeroptional (default: 20)
list_hospitals_by_state
List hospitals in a US state.
ParameterTypeRequiredDescription
statestringrequiredUS state abbreviation (e.g. MA, CA, NY).
limitintegeroptional (default: 50)
list_hospitals_by_type
List hospitals by type.
ParameterTypeRequiredDescription
hospital_typestringrequiredHospital type (Teaching, General, Children's, VA).
limitintegeroptional (default: 50)
list_hospitals_by_specialty
List hospitals with a given medical specialty.
ParameterTypeRequiredDescription
specialtystringrequiredMedical specialty (e.g. Cardiology, Oncology, Neurology).
limitintegeroptional (default: 50)
list_trauma_centers
List trauma centers by level.
ParameterTypeRequiredDescription
levelstringoptional (default: "Level I")
limitintegeroptional (default: 50)
get_hospital_states
List all US states with hospitals in the directory.
get_hospital_types
List all hospital types in the directory.
get_medical_specialties
List all medical specialties in the directory.
report_feedback
Report a bug, feature request, or general feedback for this data source.
ParameterTypeRequiredDescription
feedbackstringrequired
feedback_typestringoptional (default: "general")

Related