{"openapi":"3.0.3","info":{"title":"Gnist Context — USGS Streamflow","description":"US river and stream conditions — real-time discharge, gage height from USGS gauges.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/streamflow/`\n- **Toolkit page:** `/toolkits/streamflow`\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/streamflow/search_stream_sites":{"post":{"tags":["Environment"],"summary":"search_stream_sites","description":"Search for USGS water monitoring sites.\n\nReturns active stream gauge stations with location data.\n\nArgs:\n    state_code: US state code (e.g. \"CO\" for Colorado, \"CA\" for California). Optional.\n    limit: Maximum results (1-100, default 20).","operationId":"streamflow_search_stream_sites","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":{"state_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"limit":{"default":20,"type":"integer"}},"type":"object"}}}}}},"/rest/streamflow/get_stream_conditions":{"post":{"tags":["Environment"],"summary":"get_stream_conditions","description":"Get current river/stream conditions at a USGS monitoring site.\n\nReturns real-time discharge (flow rate) and gage height readings.\n\nArgs:\n    site_code: USGS site code (e.g. \"09380000\" for Colorado River at Lees Ferry).","operationId":"streamflow_get_stream_conditions","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":{"site_code":{"type":"string"}},"required":["site_code"],"type":"object"}}}}}},"/rest/streamflow/report_feedback":{"post":{"tags":["Environment"],"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":"streamflow_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":"Environment","description":"Data sources: Environment"}],"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."}}}}