{"openapi":"3.0.3","info":{"title":"Gnist Context — Hospital Directory","description":"US hospital directory — beds, trauma level, specialties, accreditation for major hospitals.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/hospital-directory/`\n- **Toolkit page:** `/toolkits/hospital-directory`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/hospital-directory/get_hospital":{"post":{"tags":["Health"],"summary":"get_hospital","description":"Get detailed information about a hospital.\n\nReturns name, location, type, beds, trauma level, specialties, and accreditation.","operationId":"hospital_directory_get_hospital","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"hospital_id":{"description":"Hospital ID slug (e.g. mayo-clinic-rochester, johns-hopkins).","type":"string"}},"required":["hospital_id"],"type":"object"}}}}}},"/rest/hospital-directory/search_hospitals":{"post":{"tags":["Health"],"summary":"search_hospitals","description":"Search the hospital directory.","operationId":"hospital_directory_search_hospitals","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search by name, city, or specialty.","type":"string"},"limit":{"default":20,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/hospital-directory/list_hospitals_by_state":{"post":{"tags":["Health"],"summary":"list_hospitals_by_state","description":"List hospitals in a US state.","operationId":"hospital_directory_list_hospitals_by_state","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"state":{"description":"US state abbreviation (e.g. MA, CA, NY).","type":"string"},"limit":{"default":50,"type":"integer"}},"required":["state"],"type":"object"}}}}}},"/rest/hospital-directory/list_hospitals_by_type":{"post":{"tags":["Health"],"summary":"list_hospitals_by_type","description":"List hospitals by type.","operationId":"hospital_directory_list_hospitals_by_type","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"hospital_type":{"description":"Hospital type (Teaching, General, Children's, VA).","type":"string"},"limit":{"default":50,"type":"integer"}},"required":["hospital_type"],"type":"object"}}}}}},"/rest/hospital-directory/list_hospitals_by_specialty":{"post":{"tags":["Health"],"summary":"list_hospitals_by_specialty","description":"List hospitals with a given medical specialty.","operationId":"hospital_directory_list_hospitals_by_specialty","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"specialty":{"description":"Medical specialty (e.g. Cardiology, Oncology, Neurology).","type":"string"},"limit":{"default":50,"type":"integer"}},"required":["specialty"],"type":"object"}}}}}},"/rest/hospital-directory/list_trauma_centers":{"post":{"tags":["Health"],"summary":"list_trauma_centers","description":"List trauma centers by level.","operationId":"hospital_directory_list_trauma_centers","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"level":{"default":"Level I","type":"string"},"limit":{"default":50,"type":"integer"}},"type":"object"}}}}}},"/rest/hospital-directory/get_hospital_states":{"post":{"tags":["Health"],"summary":"get_hospital_states","description":"List all US states with hospitals in the directory.","operationId":"hospital_directory_get_hospital_states","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/hospital-directory/get_hospital_types":{"post":{"tags":["Health"],"summary":"get_hospital_types","description":"List all hospital types in the directory.","operationId":"hospital_directory_get_hospital_types","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/hospital-directory/get_medical_specialties":{"post":{"tags":["Health"],"summary":"get_medical_specialties","description":"List all medical specialties in the directory.","operationId":"hospital_directory_get_medical_specialties","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/hospital-directory/report_feedback":{"post":{"tags":["Health"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"hospital_directory_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Health","description":"Data sources: Health"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}