{"openapi":"3.0.3","info":{"title":"Gnist Context — NVE Flood Warnings (Norway)","description":"Norwegian flood warnings from NVE — current county-level risk assessments, regional details with municipalities, and detailed flood warnings with severity levels (green/yellow/orange/red).\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/nve-flood/`\n- **Toolkit page:** `/toolkits/nve-flood`\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/nve-flood/get_county_overview":{"post":{"tags":["Environment"],"summary":"get_county_overview","description":"Get current flood warning levels for all Norwegian counties.\n\nReturns a summary of flood risk across Norway with activity levels\n(1=green/safe, 2=yellow/moderate, 3=orange/significant, 4=red/extreme).\nUse this to quickly check if any part of Norway has elevated flood risk.\n\nReturns:\n    County list with activity levels, plus count of counties with elevated warnings.","operationId":"nve_flood_get_county_overview","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/nve-flood/get_region_details":{"post":{"tags":["Environment"],"summary":"get_region_details","description":"Get municipalities and active warnings for a Norwegian county.\n\nDrill down into a specific county to see which municipalities are affected\nand what warnings are active.\n\nReturns:\n    Region details with municipality list and any active warnings.","operationId":"nve_flood_get_region_details","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":{"county_id":{"description":"Norwegian county ID (e.g. '03' for Oslo, '46' for Vestland, '50' for Trøndelag).","type":"string"}},"required":["county_id"],"type":"object"}}}}}},"/rest/nve-flood/get_flood_warnings":{"post":{"tags":["Environment"],"summary":"get_flood_warnings","description":"Get flood warnings for Norway, optionally filtered by county or municipality.\n\nReturns detailed flood warnings from the Norwegian Water Resources and Energy\nDirectorate (NVE). Warnings include activity level, affected areas, and\ndescriptive text explaining the flood risk.\n\nActivity levels: 1=green (safe), 2=yellow (moderate), 3=orange (significant), 4=red (extreme).\n\nReturns:\n    List of flood warnings with severity, affected areas, and validity period.","operationId":"nve_flood_get_flood_warnings","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":{"county_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by county ID (e.g. '46' for Vestland). Omit for all of Norway."},"municipality_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by municipality ID (e.g. '0301' for Oslo). Overrides county_id if set."},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start date in YYYY-MM-DD format. Defaults to today."},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End date in YYYY-MM-DD format. Defaults to 3 days from today."}},"type":"object"}}}}}},"/rest/nve-flood/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":"nve_flood_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."}}}}